Generate images using the Together AI API. Supports custom aspect ratios, save paths, and batch generation.
基于火山引擎(抖音豆包)的图像生成服务,专门设计用于与 Cursor MCP 服务集成。支持自定义图片宽高比、保存路径等功能,提供高质量图像生成能力。
Python 3.10+
推荐使用 pyenv 管理 Python 版本:
# macOS 安装 pyenv
brew install pyenv
# 安装 Python
pyenv install 3.13.2
pyenv global 3.13.2
uv 是一个快速的 Python 包管理器,需要先安装:
# macOS 安装 uv
brew install uv
# 或者使用 pip 安装
pip install uv
YOUR_API_KEY
git clone https://github.com/chenyeju295/mcp_generate_images.git
cd mcp_generate_images
python3 -m pip install fastmcp requests 'volcengine-python-sdk[ark]'
或者使用requirements.txt文件:
pip install -r requirements.txt
出现证书问题可以使用:
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 服务会报红。
设置环境变量(推荐方式):
export ARK_API_KEY=your_api_key_here
或者在 ~/.bashrc 或 ~/.zshrc 中添加:
echo 'export ARK_API_KEY=your_api_key_here' >> ~/.zshrc
source ~/.zshrc
验证环境变量已设置:
echo $ARK_API_KEY
在 mcp_server.py
中可以修改以下配置:
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,
"default_width": 1024,
"default_height": 1024,
"max_batch_size": 1
},
"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"
]
}
}
}
图像生成工具支持以下参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
prompt | 字符串 | 是 | 图片生成提示词,建议不超过500字符 |
file_name | 字符串 | 是 | 保存的文件名(不含路径,如果没有后缀则默认使用.png) |
save_folder | 字符串 | 是 | 保存目录的绝对路径 |
aspect_ratio | 字符串 | 否 | 图片的宽高比,支持 '1:1', '4:3', '16:9', '3:4', '9:16'。默认为'1:1' |
生成一张宽高比为16:9的风景图片:
generate_image(
prompt="A beautiful mountain landscape with sunset",
file_name="landscape.png",
save_folder="/Users/username/Documents/images",
aspect_ratio="16:9"
)
如果遇到问题,请检查:
错误信息 | 可能原因 | 解决方案 |
---|---|---|
"未能生成图片: API 请求超时" | 网络问题或请求耗时过长 | 使用更简单的提示词,检查网络连接 |
"未能生成图片: API 调用频率受限" | 火山引擎API频率限制 | 等待几分钟后再试 |
"未能生成图片: API 认证失败" | API密钥无效 | 检查并更新火山引擎API密钥 |
"没有权限保存图片到..." | 目录权限问题 | 确保目录存在且有写入权限 |
"不支持的宽高比" | 使用了不支持的宽高比 | 使用支持的宽高比:'1:1', '4:3', '16:9', '3:4', '9:16' |
"Failed to download generated images" | 图片下载失败 | 检查网络连接,确保能访问火山引擎的图片URL |
A template for creating MCP (ModelContextProvider) servers, configurable via environment variables.
Provides real-time Flutter/Dart documentation and pub.dev package information to AI assistants, supporting all packages on demand.
MCP server to provide Jira Tickets information to AI coding agents like Cursor.
Generate and edit images using OpenAI's DALL-E models via the official Python SDK.
Remote server (SSE/Streamable) for the latest Svelte and SvelteKit documentation
Manage Google Apps Script projects, including creation, editing, deployment, and execution. Requires Google Cloud credentials for authentication.
A minimal, containerized base for building MCP servers with the Python SDK, featuring a standardized Docker image and local development setup.
A server for a structured, LLM-based coding workflow, from feature clarification and planning to phased development and progress tracking.
A server for JavaScript/TypeScript development with intelligent project tooling and testing capabilities.
Perform symbolic mathematics and computer algebra using the SymPy library.