即梦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-apicore

2. 安装依赖

pip install -r requirements.txt

3. 配置环境变量

# 复制环境变量模板
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联系。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jimeng_mcp_apicore-1.0.2.tar.gz (15.4 kB view details)

Uploaded Sep 18, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

jimeng_mcp_apicore-1.0.2-py3-none-any.whl (14.0 kB view details)

Uploaded Sep 18, 2025 Python 3

File details

Details for the file jimeng_mcp_apicore-1.0.2.tar.gz.

File metadata

Download URL: jimeng_mcp_apicore-1.0.2.tar.gz
Upload date: Sep 18, 2025
Size: 15.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for jimeng_mcp_apicore-1.0.2.tar.gz
Algorithm	Hash digest
SHA256	`3ea0654a337afb91c2d64c2a7642a8b171df4ea7e1fd6e8d5c4679af84b209f7`
MD5	`d1134c5d7620241ab8fcb36723310db3`
BLAKE2b-256	`50eec59b9747dcb4d67a13e65a205e274d544524d4b88841880fd8b7d13d41d6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for jimeng_mcp_apicore-1.0.2.tar.gz:

Publisher: publish.yml on Ceeon/jimeng-mcp-apicore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: jimeng_mcp_apicore-1.0.2.tar.gz
- Subject digest: 3ea0654a337afb91c2d64c2a7642a8b171df4ea7e1fd6e8d5c4679af84b209f7
- Sigstore transparency entry: 533650134
- Sigstore integration time: Sep 18, 2025
Source repository:
- Permalink: Ceeon/jimeng-mcp-apicore@9b8fca9cb0881f3c230101b969419c00088c0012
- Branch / Tag: refs/tags/v1.0.2
- Owner: https://github.com/Ceeon
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@9b8fca9cb0881f3c230101b969419c00088c0012
- Trigger Event: release

File details

Details for the file jimeng_mcp_apicore-1.0.2-py3-none-any.whl.

File metadata

Download URL: jimeng_mcp_apicore-1.0.2-py3-none-any.whl
Upload date: Sep 18, 2025
Size: 14.0 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for jimeng_mcp_apicore-1.0.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3e553d1cf347913cf559c55924e9ef2f016012f2725f5138c7e30adf62be3f5e`
MD5	`3bfbb4360dce6ed3629fe851fad6787a`
BLAKE2b-256	`745955efcbbc0a9d836b73afb8b7df5bc5ae5e9fe50ae1a290094a35d428e692`

See more details on using hashes here.

Provenance

The following attestation bundles were made for jimeng_mcp_apicore-1.0.2-py3-none-any.whl:

Publisher: publish.yml on Ceeon/jimeng-mcp-apicore

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: jimeng_mcp_apicore-1.0.2-py3-none-any.whl
- Subject digest: 3e553d1cf347913cf559c55924e9ef2f016012f2725f5138c7e30adf62be3f5e
- Sigstore transparency entry: 533650138
- Sigstore integration time: Sep 18, 2025
Source repository:
- Permalink: Ceeon/jimeng-mcp-apicore@9b8fca9cb0881f3c230101b969419c00088c0012
- Branch / Tag: refs/tags/v1.0.2
- Owner: https://github.com/Ceeon
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@9b8fca9cb0881f3c230101b969419c00088c0012
- Trigger Event: release

Release history Release notifications | RSS feed

This release

1.0.2 This release

Sep 18, 2025 2 files

1.0.1

Sep 17, 2025 2 files

1.0.0

Sep 17, 2025 2 files

jimeng-mcp-apicore 1.0.2

即梦AI MCP服务器 - APICore渠道版

✨ 特色功能

🚀 快速开始

1. 克隆仓库

2. 安装依赖

3. 配置环境变量

4. 配置Claude Desktop

5. 重启Claude Desktop

📚 使用示例

基础用法

简单文生图

指定尺寸

🌟 高级功能

图生图（参考图生成）

📚 组图生成（重点！）

批量生成

风格和质量控制

📊 参数说明

🌐 支持的尺寸

⚡ 性能优化

🔧 APICore配置

⚠️ 注意事项

🤝 贡献

📝 License

📧 联系

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed