MCP 服务器

jimeng-mcp-apicore

Enables image generation using Jimeng AI (Doubao Seedream 4.0) via APICore, supporting text-to-image, image-to-image, multi-image fusion, and batch generation.

README

即梦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	超宽屏