即梦AI MCP服务器 - 火山引擎官方API版
直接调用火山引擎官方API (doubao-seedream-4.0) 的MCP服务器，支持文生图、图生图、多图融合、组图生成等全部功能。
✨ 特色功能
- 🎨 文生图：根据文字描述生成高质量图像
- 🖼️ 图生图：基于参考图片生成新图像
- 🎭 多图融合：融合多张参考图的元素（最多10张）
- 📚 组图生成：一次生成多张主题相关的图片（最多15张）
- 🚀 批量处理：支持多个prompt批量生成
- 💾 自动保存：生成的图片自动下载并保存到本地
- 🌐 官方直连：直接调用火山引擎官方API，稳定可靠
🚀 快速开始
1. 克隆仓库
git clone https://github.com/yourusername/jimeng-mcp-volcengine.git
cd jimeng-mcp-volcengine
2. 安装依赖
pip install -r requirements.txt
3. 配置环境变量
# 复制环境变量模板
cp .env.example .env
# 编辑.env文件，填入您的API密钥
vi .env
# 或者直接设置环境变量
export ARK_API_KEY="your-api-key"
export JIMENG_OUTPUT_DIR="./outputs"
4. 配置 Claude Desktop
编辑配置文件：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
添加以下配置：
{
"mcpServers": {
"jimeng-volc": {
"command": "python3",
"args": ["/path/to/jimeng_mcp.py"],
"env": {
"ARK_API_KEY": "your-api-key",
"JIMENG_OUTPUT_DIR": "~/Desktop/jimeng_images"
}
}
}
}
5. 重启 Claude Desktop
📚 使用示例
基础用法
# 简单文生图
jimeng("一只可爱的猫咪在花园里玩耍")
# 指定尺寸
jimeng("壮丽的山水风景画", size="16:9")
# 关闭水印
jimeng("产品图", watermark=False)
🌟 高级功能
图生图（参考图生成）
# 单张参考图
jimeng("改为卡通风格", image="http://example.com/photo.jpg")
# 多张参考图融合
jimeng(
prompt="融合这些元素创造新场景",
image=["url1.jpg", "url2.jpg", "url3.jpg"]
)
📚 组图生成（重点！）
组图生成使用auto模式，AI会根据prompt内容自动决定生成数量：
# 示例1：生成3张不同时间的图片
jimeng(
prompt="生成3张不同时间段的海边风景：日出、正午、日落",
sequential="auto",
max_images=3 # 设置上限为3张
)
# 示例2：生成5张不同风格
jimeng(
prompt="生成5张不同艺术风格的花朵：油画、水彩、素描、国画、卡通",
sequential="auto",
max_images=5
)
# 示例3：故事叙述
jimeng(
prompt="生成4张图讲述小猫的一天：起床、吃饭、玩耍、睡觉",
sequential="auto",
max_images=4
)
重要提示：
- 在prompt中明确说明需要的数量（如"生成3张"）
- 详细描述每张图的内容
max_images参数设置为期望的数量
批量生成
# 多prompt批量生成
jimeng(["猫咪", "小狗", "兔子", "仓鼠"])
📊 参数说明
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
prompt |
str/list | 必需 | 生成描述文本 |
image |
str/list | None | 参考图片URL（最多10张） |
size |
str | "1:1" | 图片尺寸比例 |
watermark |
bool | False | 是否添加水印 |
sequential |
str | "disabled" | 组图模式(auto/disabled) |
max_images |
int | 15 | 组图最大数量(1-15) |
stream |
bool | False | 是否流式传输 |
🌐 支持的尺寸
| 比例 | 像素值 | 适用场景 |
|---|---|---|
1:1 |
2048×2048 | 正方形，社交媒体 |
4:3 |
2304×1728 | 横向标准 |
3:4 |
1728×2304 | 纵向标准 |
16:9 |
2560×1440 | 宽屏，电影 |
9:16 |
1440×2560 | 竖屏，手机 |
3:2 |
2496×1664 | 横向照片 |
2:3 |
1664×2496 | 纵向照片 |
21:9 |
3024×1296 | 超宽屏 |
⚡ 性能优势
- 支持流式传输，实时返回生成进度
- 动态超时设置，根据任务复杂度调整
- 直连官方API，响应速度快
- 智能错误处理，友好提示信息
🔧 火山引擎配置
- 注册火山引擎账号：https://console.volcengine.com/
- 开通方舟（Ark）服务
- 获取API Key
- 开通 doubao-seedream-4-0-250828 模型
⚠️ 注意事项
-
API限制
- 提示词建议≤300汉字或600英文单词
- 参考图最多10张，每张≤10MB
- 组图生成：参考图+生成图总数≤15张
-
图片保存
- 默认保存到配置的输出目录
- URL格式的图片链接24小时后失效
- 建议及时下载保存
-
组图生成
- 使用auto模式时，在prompt中明确数量
- 详细描述每张图的变化或特点
- 合理设置max_images参数
🤝 贡献
欢迎提交Issue和Pull Request！
📝 License
MIT License - 详见 LICENSE 文件
📧 联系
如有问题或建议，请通过GitHub Issues联系。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file jimeng_mcp_volcengine-1.0.2.tar.gz.
File metadata
- Download URL: jimeng_mcp_volcengine-1.0.2.tar.gz
- Upload date:
- Size: 13.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d471d34dc8b2332f357dc3238fb065e086032197519cca47a14cd7a8a3b721aa
|
|
| MD5 |
5772359811cc7c082031a0a5730e7f22
|
|
| BLAKE2b-256 |
18fca804c4115e316e2c54cef758e278460c55af741f17fb82094dc7ca4dbb23
|
Provenance
The following attestation bundles were made for jimeng_mcp_volcengine-1.0.2.tar.gz:
Publisher:
publish.yml on Ceeon/jimeng-mcp-volcengine
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
jimeng_mcp_volcengine-1.0.2.tar.gz -
Subject digest:
d471d34dc8b2332f357dc3238fb065e086032197519cca47a14cd7a8a3b721aa - Sigstore transparency entry: 533654110
- Sigstore integration time:
-
Permalink:
Ceeon/jimeng-mcp-volcengine@a9a4308cf1bba86c71f62414a97c07292f443e10 -
Branch / Tag:
refs/tags/v1.0.2 - Owner: https://github.com/Ceeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a9a4308cf1bba86c71f62414a97c07292f443e10 -
Trigger Event:
release
-
Statement type:
File details
Details for the file jimeng_mcp_volcengine-1.0.2-py3-none-any.whl.
File metadata
- Download URL: jimeng_mcp_volcengine-1.0.2-py3-none-any.whl
- Upload date:
- Size: 12.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e6ebe616c6f16c9c2ef89ae820e965992650d29a0ffdb3a45f860018c7119eb
|
|
| MD5 |
b0bdcc25bf3ff3584e9209db440ef8f8
|
|
| BLAKE2b-256 |
d0fbf2dc6fa70e03ee23f5bfa3ef1d9eb1897abb861ef2888c5c740d1a6abe45
|
Provenance
The following attestation bundles were made for jimeng_mcp_volcengine-1.0.2-py3-none-any.whl:
Publisher:
publish.yml on Ceeon/jimeng-mcp-volcengine
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
jimeng_mcp_volcengine-1.0.2-py3-none-any.whl -
Subject digest:
8e6ebe616c6f16c9c2ef89ae820e965992650d29a0ffdb3a45f860018c7119eb - Sigstore transparency entry: 533654116
- Sigstore integration time:
-
Permalink:
Ceeon/jimeng-mcp-volcengine@a9a4308cf1bba86c71f62414a97c07292f443e10 -
Branch / Tag:
refs/tags/v1.0.2 - Owner: https://github.com/Ceeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@a9a4308cf1bba86c71f62414a97c07292f443e10 -
Trigger Event:
release
-
Statement type:
