SeeDream Image MCP

基于火山引擎 SeeDream 模型的 MCP (Model Context Protocol) 图片生成工具。

✨ 特性

• 🎨 使用火山引擎 SeeDream 4.0 模型生成高质量图片
• 🔧 支持自定义尺寸、智能参考图等
• 📝 无需编写复杂提示词，AI自动根据需求生成生图提示词
• 🔌 MCP 协议支持，可在 Cursor、Claude Desktop 等客户端中使用

📺 演示

<video src="https://github.com/user-attachments/assets/2b82a9d4-7799-4625-a140-2a48845b2e4a" autoplay muted loop playsinline controls width="100%" height="auto"></video>

🚀 快速开始

1. 获取火山引擎 API Key

前往 火山引擎->火山方舟控制台 开通服务并申请 API Key。

2. 使用 npx 运行

npx @hongxianzhi/seedream-image-mcp --ark-key=YOUR_API_KEY [--ark-model=MODEL_NAME] [--ark-endpoint=REQUEST_ENDPOINT]

参数说明：

• --ark-key (必需) - 火山引擎 API Key
• --ark-model (可选) - 模型名称，默认 doubao-seedream-4-5-251128
• --ark-endpoint (可选) - 请求地址，默认 https://ark.cn-beijing.volces.com/api/v3/images/generations

3. 在 Cursor、Claude Desktop 中配置

编辑 Cursor MCP配置 或 claude_desktop_config.json:

{
  "mcpServers": {
    "seedream-image": {
      "command": "npx",
      "args": ["@hongxianzhi/seedream-image-mcp", "--ark-key=YOUR_API_KEY", "--ark-model=doubao-seedream-4-5-251128", "--ark-endpoint=https://ark.cn-beijing.volces.com/api/v3/images/generations"]
    }
  }
}

📖 使用示例

在 AI Agent 工具中，你可以这样使用：

为这个页面添加合适的图片，避免过于单调

AI 会自动调用工具完成生成。

📌 注意事项

图片链接时效性：本项目使用火山引擎原始 API，生成的图片链接通常在 24 小时后失效。如果你需要长期保存图片，请及时下载到本地。

🔄 两种使用方式

你可以根据自己的需求选择：

方式一：本地运行 🔧

• 需要自己申请火山引擎 API key
• 图片链接 24 小时后失效，需下载到本地使用。

方式二：云端版本 ✨

• ✅ 无需申请 API key，开箱即用
• ✅ 图片支持永久存储在 CDN
• ✅ 支持 webp 压缩、背景移除、快速并发生成多张图片等功能
• ✅ 提供一定的免费额度
• ✅ 量大时价格更优惠

👉 了解云端版本：https://mcp.pixelark.art

---

🛠️ 开发

安装依赖

npm install

编译项目

npm run build

全局安装

如需全局安装此包以便在命令行中使用，可执行以下步骤：

# 1. 正常编译
npm run build

# 2. 拷贝 dist/index.js 到全局 npm 目录
cp dist/index.js "$(npm prefix -g)/lib/node_modules/seedream-image-mcp/dist/index.js"

# 3. 创建符号链接到全局目录
ln -sf "$(npm prefix -g)/lib/node_modules/seedream-image-mcp/dist/index.js" "$(npm prefix -g)/bin/seedream-image-mcp"

或者使用 npm link（推荐）：

npm run build
npm link

📄 许可证

MIT

🔗 相关链接

• 云端版本
• 火山引擎 SeeDream
• MCP 协议