即梦AI MCP服务器 - APICore渠道版
基于APICore平台调用即梦AI (Doubao Seedream 4.0) 的MCP服务器，支持文生图、图生图、多图融合、组图生成等全部功能。
✨ 特色功能
- 🎨 文生图：根据文字描述生成高质量图像
- 🖼️ 图生图：基于参考图片生成新图像
- 🎭 多图融合：融合多张参考图的元素（最多10张）
- 📚 组图生成：一次生成多张主题相关的图片（最多15张）
- 🚀 批量处理：支持多个prompt批量生成
- 💾 自动保存：生成的图片自动下载并保存到本地
🚀 快速开始
1. 克隆仓库
git clone https://github.com/yourusername/jimeng-mcp-apicore.git
cd jimeng-mcp-apicore2. 安装依赖
pip install -r requirements.txt3. 配置环境变量
# 复制环境变量模板
cp .env.example .env
# 编辑.env文件，填入您的API密钥
vi .env
# 或者直接设置环境变量
export APICORE_API_KEY="sk-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": {
"command": "python3",
"args": ["/path/to/jimeng_mcp.py"],
"env": {
"APICORE_API_KEY": "sk-your-api-key",
"JIMENG_OUTPUT_DIR": "~/Desktop/jimeng_images"
}
}
}
}5. 重启Claude Desktop
📚 使用示例
基础用法
简单文生图
jimeng("一只可爱的猫咪在花园里玩耍")指定尺寸
jimeng(
prompt="壮丽的山水风景画",
size="16:9" # 宽屏格式
)🌟 高级功能
图生图（参考图生成）
# 单张参考图
jimeng("改为卡通风格", image="http://example.com/cat.jpg")
# 多张参考图融合
jimeng(
prompt="融合这些元素创造新场景",
image=["url1.jpg", "url2.jpg", "url3.jpg"]
)📚 组图生成（重点！）
组图生成使用auto模式，AI会根据prompt内容自动决定生成数量：
# 示例1：生成3张不同时间的图片
jimeng(
prompt="生成3张不同时间段的城市风景：早晨的朝阳、中午的繁忙、夜晚的灯火",
sequential_image_generation="auto",
max_images=3 # 设置上限为3张
)
# 示例2：生成5张不同角度的产品展示
jimeng(
prompt="生成5张白色iPhone的不同角度展示：正面、背面、左侧、右侧、45度角",
sequential_image_generation="auto",
max_images=5
)
# 示例3：四季变化
jimeng(
prompt="生成4张展示同一棵树的四季变化：春天发芽、夏天繁茂、秋天金黄、冬天雪景",
sequential_image_generation="auto",
max_images=4
)重要提示：
- 在prompt中明确说明需要的数量（如"生成3张"）
- 详细描述每张图的内容
max_images参数设置为期望的数量
批量生成
# 单prompt生成多张
jimeng("科幻城市", n=4)
# 多prompt批量生成
jimeng(["猫咪", "小狗", "兔子", "仓鼠"])风格和质量控制
# 预设风格
jimeng("樱花树下的少女", style="anime")
# 高质量生成
jimeng("精致的艺术品", quality="high")
# 关闭水印
jimeng("产品图", watermark=False)📊 参数说明
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
prompt | str/list | 必需 | 生成描述文本 |
image | str/list | None | 参考图片URL（最多10张） |
size | str | "1:1" | 图片尺寸比例 |
n | int | 1 | 每个prompt生成数量(1-4) |
watermark | bool | False | 是否添加水印 |
stream | bool | False | 是否流式传输 |
style | str | None | 预设艺术风格 |
quality | str | "standard" | 生成质量等级 |
sequential_image_generation | str | "disabled" | 组图模式(auto/disabled) |
max_images | int | 15 | 组图最大数量(1-15) |
response_format | str | "url" | 返回格式(url/b64_json) |
🌐 支持的尺寸
| 比例 | 像素值 | 适用场景 |
|---|---|---|
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 | 超宽屏 |
⚡ 性能优化
- 支持流式传输，实时返回生成进度
- 动态超时设置，根据任务复杂度调整
- 自动重试机制，提高成功率
- 智能错误处理，友好提示信息
🔧 APICore配置
- 注册APICore账号：https://api.apicore.ai/
- 获取API密钥
- 确保开通了 doubao-seedream-4-0 模型服务
⚠️ 注意事项
- API限制
- 提示词建议≤300汉字或600英文单词 - 参考图最多10张，每张≤10MB - 组图生成：参考图+生成图总数≤15张
- 图片保存
- 默认保存到配置的输出目录 - URL格式的图片链接24小时后失效 - 建议及时下载保存
- 组图生成
- 使用auto模式时，在prompt中明确数量 - 详细描述每张图的变化或特点 - 合理设置max_images参数
🤝 贡献
欢迎提交Issue和Pull Request！
📝 License
MIT License - 详见 LICENSE 文件
📧 联系
如有问题或建议，请通过GitHub Issues联系。