mcp_generate_images

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

• 支持高质量图像生成
• 多种常见宽高比支持（1:1、4:3、16:9、3:4、9:16）
• 可调整生成步数以平衡质量与速度
• 自动重试和详细错误处理
• 支持批量生成多张图片
• 完整的路径和权限验证
• 详细的错误提示和日志
• 异步处理支持

• Python 3.10+

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

• 推荐使用 pyenv 管理 Python 版本：

# macOS 安装 pyenv
brew install pyenv

# 安装 Python
pyenv install 3.13.2
pyenv global 3.13.2

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

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

# macOS 安装 uv
brew install uv

# 或者使用 pip 安装
pip install uv

1. 访问 Together AI API Keys
2. 注册/登录账号
3. 创建新的 API 密钥
4. 复制密钥并保存，格式如：YOUR_API_KEY

• 下载并安装 Cursor IDE
• 确保 Cursor 已正确配置 Python 环境

git clone https://github.com/chenyeju295/mcp_generate_images.git
cd mcp_generate_images

python3 -m pip install fastmcp requests

出现证书问题可以使用：

python3 -m pip install fastmcp requests --trusted-host pypi.org --trusted-host files.pythonhosted.org --upgrade --force-reinstall --no-cache-dir

tips: 需确保安装成功，否则配置MCP 服务会报红。

在 mcp_server.py 中修改 TOGETHER_API_KEY：

TOGETHER_API_KEY = "your_api_key_here"  # 替换为你的 Together AI API 密钥

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

CONFIG = {
    "api": {
        "url": "https://api.together.xyz/v1/images/generations",
        "model": "black-forest-labs/FLUX.1-schnell-Free",
        "timeout": 60,
        "max_retries": 3,
        "retry_delay": 5
    },
    "image": {
        "max_width": 1024,   
        "max_height": 1024, 
        "default_width": 1024,
        "default_height": 1024,
        "default_steps": 3,
        "max_batch_size": 4
    },
    "output": {
        "base_folder": "你的默认保存路径",
        "allowed_extensions": [".png", ".jpg", ".jpeg"],
        "default_extension": ".png"
    }
}

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

uv run --with fastmcp fastmcp dev /Users/username/Documents/mcp_generate_images/mcp_server.py

在 Cursor 的 MCP 配置中添加：

{
  "mcpServers": {
    "generate_images": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "/Users/chenyeju/Documents/github/mcp_generate_images/mcp_server.py"
      ]
    } 
  }
}

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

生成一张宽高比为16:9的风景图片，使用步数2以加快生成速度：

generate_image(
  prompt="A beautiful mountain landscape with sunset", 
  file_name="landscape.png", 
  save_folder="/Users/username/Documents/images", 
  aspect_ratio="16:9", 
  steps=2
)

1. 尺寸限制：虽然配置文件支持最大1440x1440的尺寸，但当前使用的模型（FLUX.1-schnell-Free）实际上仅支持最大1024x1024的尺寸。
2. 长宽比：建议使用1:1的宽高比（正方形图片），例如512x512或1024x1024，以获得最佳效果和生成速度。
3. 提示词：简洁明了的提示词通常能获得更好的结果，尽量不超过500字符。
4. 超时问题：对于复杂提示词或非正方形图片，生成可能需要更长时间，有时会导致超时错误。
5. 步数选择：
   • 步数=1：速度最快，但质量最低
   • 步数=2：平衡速度和质量
   • 步数=3：默认值，较好的质量
   • 步数=4：质量最高，但速度最慢

如果遇到问题，请检查：

1. 服务是否正常运行
2. 保存路径是否正确（必须是绝对路径）
3. 目录权限是否正确
4. 网络连接是否正常
5. API 密钥是否有效
6. Python 环境是否正确配置
7. uv 是否正确安装
8. 依赖包是否完整安装