JinDaGe - seedream-image-mcp MCP Details

article

README

🚀 SeeDream Image MCP

SeeDream Image MCP 是一款基于火山引擎 SeeDream 模型的 MCP（Model Context Protocol）图片生成工具，能够帮助用户轻松生成高质量图片，提升创作效率。

✨ 主要特性

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

📺 演示

🚀 快速开始

1. 获取火山引擎 API Key

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

2. 使用 npx 运行

npx seedream-image-mcp --ark-key=YOUR_API_KEY

3. 在 Cursor、Claude Desktop 中配置

编辑 Cursor MCP配置 或 claude_desktop_config.json：

{
  "mcpServers": {
    "seedream-image": {
      "command": "npx",
      "args": ["seedream-image-mcp", "--ark-key=YOUR_API_KEY"]
    }
  }
}

💻 使用示例

基础用法

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

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

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

📌 注意事项

⚠️ 重要提示

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

🔄 两种使用方式

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

方式一：本地运行 🔧

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

方式二：云端版本 ✨

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

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

🛠️ 开发

安装依赖

bun install

本地运行

bun run src/index.ts --ark-key=YOUR_API_KEY

📄 许可证

本项目采用 MIT 许可证。

seedream-image-mcp