JinDaGe - mcp_generate_images MCP Details

article

README

🚀 AI 图像生成工具文档

本工具基于 Together AI 平台，为用户提供图像生成服务，并集成到 Cursor MCP 系统中。通过参数配置，能够生成高质量图片，适用于多种应用场景。

🚀 快速开始

本工具需特定的运行环境，在安装前请确保您的系统和软件符合以下要求：

操作系统

推荐：macOS 10.15 及以上版本、Windows 10 及以上版本、Linux（Ubuntu 20.04 及以上）
最低要求：macOS 10.12 及以上、Windows 8 及以上、Linux（Ubuntu 16.04 及以上）

软件依赖

Python 3.7 及以上版本
必要的依赖库已自动包含在安装包中

✨ 主要特性

多语言支持：支持多语言提示词输入，包括中文、英文等。
丰富的尺寸与宽高比选项：提供多种尺寸和宽高比选项，满足不同场景需求。
批量处理能力：支持一次性生成多个图片，提高工作效率，还可设置生成参数模板，方便重复使用。

📦 安装指南

下载工具包

访问官方下载页面获取最新版本的安装包。

安装步骤

# 解压安装包
tar -xzf ai-image-generator-toolkit-vX.Y.Z.tar.gz

# 进入解压目录
cd ai-image-generator-toolkit-vX.Y.Z

# 安装依赖
pip install -r requirements.txt

# 启动服务
python main.py

📚 详细文档

配置说明

核心配置文件

主配置文件：config.json

{
    "api_key": "your_api_key_here",
    "max_image_size": "1024x1024",
    "supported_aspect_ratios": ["1:1", "4:3", "16:9", "3:4", "9:16"],
    "default_params": {
        "steps": 3,
        "aspect_ratio": "1:1"
    }
}

参数解释 | 参数名 | 类型 | 是否必填 | 默认值 | 说明 | |----------------|--------|----------|--------------|--------------------------| | api_key | string | 是 | | API 访问密钥 | | max_image_size | string | 否 | "1024x1024" | 支持的最大图像尺寸 | | supported_aspect_ratios | array | 否 | ["1:1", "4:3", ...] | 支持的宽高比列表 | | default_params | object | 否 | {steps:3, aspect_ratio:"1:1"} | 默认生成参数 |

参数详解

| 参数名 | 类型 | 是否必填 | 有效范围 | 说明 | |----------------|--------|----------|------------------------------|--------------------------| | prompt | string | 是 | 最多 500 字符 | 图像生成的提示词 | | file_name | string | 是 | 支持常见图片格式 | 保存的文件名（不含路径） | | save_folder | string | 是 | 绝对路径 | 文件保存目录 | | aspect_ratio | string | 否 | '1:1', '4:3', '16:9', '3:4', '9:16' | 宽高比选项 | | width | integer | 否 | 1 - 2048 | 图片宽度（像素） | | height | integer | 否 | 1 - 2048 | 图片高度（像素） | | quality | integer | 否 | 1 - 100 | 图片质量，值越高越清晰 | | style | string | 否 | "realistic", "artistic", ... | 图像生成风格 |

💻 使用示例

基础用法

# 示例 1：生成标准尺寸的图像
generate_image(
    prompt="一只飞翔的鸟儿在蓝天中",
    file_name="bird.jpg",
    save_folder="/Users/username/Pictures",
    aspect_ratio="1:1"
)

高级用法

# 示例 2：批量生成不同宽高比的图像
params_list = [
    {"prompt": "森林清晨", "file_name": "forest_morning", "aspect_ratio": "4:3"},
    {"prompt": "沙漠日落", "file_name": "desert_sunset", "aspect_ratio": "16:9"}
]
batch_generate(params_list)

⚠️ 注意事项

性能提示

建议在稳定的网络环境下使用。
处理大批量请求时，建议分批次处理以保证成功率。

安全须知

请勿泄露 API 密钥给他人。
遵守当地法律法规，合理使用生成内容。

故障排除

如遇网络问题，请检查网络连接。
若提示参数错误，请核对参数格式和取值范围。

📈 更新日志

v1.0.0（2024 - 03 - 20）

初始版本发布，包含基本图像生成功能。
支持中文和英文双语提示词输入。

v1.1.0（2024 - 04 - 15）

新增批量生成功能。
优化 API 调用性能，提升响应速度。

v1.2.0（2024 - 05 - 01）

支持自定义宽高比和尺寸设置。
增加错误处理机制，提高稳定性。

📞 联系我们

如需技术支持或反馈问题，请访问官方支持页面联系我们的客服团队。

mcp_generate_images