Mcp_generate_images

🚀 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"} | 默认生成参数 |

参数详解

💻 使用示例

基础用法

# 示例 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）

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

📞 联系我们

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