iflow-mcp_chenyeju295-mcp_generate_images

# AI 图像生成服务 基于火山引擎（抖音豆包）的图像生成服务，专门设计用于与 Cursor MCP 服务集成。支持自定义图片宽高比、保存路径等功能，提供高质量图像生成能力。 ## 功能特点 - 支持高质量图像生成 - 多种常见宽高比支持（1:1、4:3、16:9、3:4、9:16） - 火山引擎豆包模型（doubao-seedream-3-0-t2i-250415） - 自动重试和详细错误处理 - 完整的路径和权限验证 - 详细的错误提示和日志 - 异步处理支持 ## 环境准备 ### 1. Python 环境 - Python 3.10+ - 下载地址： <https://www.python.org/downloads/> - 推荐使用 pyenv 管理 Python 版本： ```bash # macOS 安装 pyenv brew install pyenv # 安装 Python pyenv install 3.13.2 pyenv global 3.13.2 ``` ### 2. Nodejs 环境 - 下载地址： <https://nodejs.org/zh-cn> ### 3. uv 包管理工具 uv 是一个快速的 Python 包管理器，需要先安装： ```bash # macOS 安装 uv brew install uv # 或者使用 pip 安装 pip install uv ``` ### 4. 火山引擎 API 密钥 1. 访问 [火山引擎方舟大模型服务](https://console.volcengine.com/ark) 2. 注册/登录账号 3. 创建新的 API 密钥 4. 复制密钥并保存，格式如：`YOUR_API_KEY` ### 5. Cursor - 下载并安装 [Cursor IDE](https://cursor.sh/) - 确保 Cursor 已正确配置 Python 环境 ## 安装配置 ### 1. 克隆项目 ```bash git clone https://github.com/chenyeju295/mcp_generate_images.git cd mcp_generate_images ``` ### 2. 安装依赖(cd 到mcp_generate_images 安装) ```bash python3 -m pip install fastmcp requests 'volcengine-python-sdk[ark]' ``` 或者使用requirements.txt文件： ```bash pip install -r requirements.txt ``` 出现证书问题可以使用： ```bash python3 -m pip install fastmcp requests 'volcengine-python-sdk[ark]' --trusted-host pypi.org --trusted-host files.pythonhosted.org --upgrade --force-reinstall --no-cache-dir ``` tips: 需确保安装成功，否则配置MCP 服务会报红。 ### 3. 配置 API 密钥 设置环境变量（推荐方式）： ```bash export ARK_API_KEY=your_api_key_here ``` 或者在 ~/.bashrc 或 ~/.zshrc 中添加： ```bash echo 'export ARK_API_KEY=your_api_key_here' >> ~/.zshrc source ~/.zshrc ``` 验证环境变量已设置： ```bash echo $ARK_API_KEY ``` ### 4. 配置服务 在 `mcp_server.py` 中可以修改以下配置： ```python CONFIG = { "api": { "base_url": "https://ark.cn-beijing.volces.com/api/v3", "model": "doubao-seedream-3-0-t2i-250415", "timeout": 120, "max_retries": 3, "retry_delay": 5 }, "image": { "max_width": 1024, "max_height": 1024, "de…