返回 MCP 目录
public公开dns本地运行

seedream-image-mcp

基于火山引擎SeeDream模型的MCP图片生成工具,支持高质量图片生成、自定义尺寸和智能参考图,可通过MCP协议在Cursor、Claude Desktop等客户端中使用。

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 许可证。

🔗 相关链接

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端