mcp_generate_images | 通往MCP之路

AI 图像生成服务

基于 Together AI 的图像生成服务，专为与 Cursor MCP 服务集成而设计。支持自定义图片宽高比、保存路径等功能，提供高质量图像生成能力。

功能特点

支持高质量图像生成

多种常见宽高比支持（1:1、4:3、16:9、3:4、9:16）

可调整生成步数以平衡质量与速度

自动重试和详细错误处理

支持批量生成多张图片

完整的路径和权限验证

详细的错误提示和日志

异步处理支持

环境准备

1. Python 环境

Python 3.10+

下载地址： https://www.python.org/downloads/

推荐使用 pyenv 管理 Python 版本：

2. Nodejs 环境

下载地址： https://nodejs.org/zh-cn

3. uv 包管理工具

uv 是一个快速的 Python 包管理器，需要先安装：

4. Together AI API 密钥

访问 Together AI API Keys

创建新的 API 密钥

复制密钥并保存，格式如：YOUR_API_KEY

5. Cursor

下载并安装 Cursor IDE

确保 Cursor 已正确配置 Python 环境

安装配置

1. 克隆项目

2. 安装依赖（cd 到 mcp_generate_images 目录后安装）

出现证书问题可以使用：

提示：需确保安装成功，否则配置 MCP 服务时会报错。

3. 配置 API 密钥

在 mcp_server.py 中修改 TOGETHER_API_KEY：

4. 配置服务

在 mcp_server.py 中可以修改以下配置：

运行服务

开发模式运行（带调试界面）：

在 Cursor 中使用

1. 在 Cursor 中引入 MCP 服务

在 Cursor 的 MCP 配置中添加：

3. 服务运行成功示例

!image.png

4. 在 Cursor Composer 的 agent 模式下使用

!image.png

参数说明

图像生成工具支持以下参数：

参数名	类型	必填	说明
prompt	字符串	是	图片生成提示词，建议不超过500字符
file_name	字符串	是	保存的文件名(不含路径，如果没有后缀则默认使用.png)
save_folder	字符串	是	保存目录的绝对路径
aspect_ratio	字符串	否	图片的宽高比，支持 '1:1', '4:3', '16:9', '3:4', '9:16'。默认为'1:1'
steps	数字	否	生成的推理/采样步数，支持值1-4，默认为3。步数越多质量越高但耗时越长

使用示例

使用注意事项

尺寸限制：虽然配置文件支持最大1440x1440的尺寸，但当前使用的模型（FLUX.1-schnell-Free）实际上仅支持最大1024x1024的尺寸。

长宽比：建议使用1:1的宽高比（正方形图片），例如512x512或1024x1024，以获得最佳效果和生成速度。

提示词：简洁明了的提示词通常能获得更好的结果，尽量不超过500字符。

超时问题：对于复杂提示词或非正方形图片，生成可能需要更长时间，有时会导致超时错误。

步数选择：

步数=1：速度最快，但质量最低

步数=2：平衡速度和质量

步数=3：默认值，较好的质量

步数=4：质量最高，但速度最慢

错误排查

如果遇到问题，请检查：

服务是否正常运行

保存路径是否正确（必须是绝对路径）

网络连接是否正常

API 密钥是否有效

Python 环境是否正确配置

uv 是否正确安装

依赖包是否完整安装

常见错误及解决方案

错误信息	可能原因	解决方案
"未能生成图片: API 请求超时"	网络问题或请求耗时过长	尝试减少steps值，或使用更简单的提示词
"未能生成图片: API 调用频率受限"	Together API频率限制	等待几分钟后再试
"未能生成图片: API 认证失败"	API密钥无效	检查并更新API密钥
"没有权限保存图片到..."	目录权限问题	确保目录存在且有写入权限
"steps参数必须在1-4之间"	steps参数超出范围	使用1-4之间的值
"不支持的宽高比"	使用了不支持的宽高比	使用支持的宽高比：'1:1', '4:3', '16:9', '3:4', '9:16'