Seedream/Seedance MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Seedream/Seedance MCP Server Generate a 5-second video of a cat wearing a space suit on Mars"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
火山方舟 Seedream / Seedance MCP 服务
一个基于火山方舟(Ark)API 的 MCP 服务,提供:
Seedream 图片生成/编辑
Seedance 视频生成(异步任务)
本地
stdio与远程http两种接入模式
功能概览
能力 | 状态 | 说明 |
图片生成/编辑 | 可用 | 基于 |
视频生成 | 可用 | 基于 |
本地接入 | 可用 |
|
远程接入 | 可用 |
|
Related MCP server: Seedream 4.0 MCP Server
快速开始
环境要求
Node.js 18+
pnpm
安装依赖
pnpm install构建
pnpm build环境变量
变量名 | 必填 | 默认值 | 说明 |
| 是 | - | 火山方舟 API Key |
| 否 |
| 传输模式: |
| 否 |
|
|
| 否 |
|
|
| 否 |
|
|
可在项目根目录创建 .env:
ARK_API_KEY=your_ark_api_key
MCP_TRANSPORT=stdio启动方式
1. 本地模式(默认,stdio)
pnpm build
node build/index.js2. 远程模式(http)
PowerShell 示例:
$env:ARK_API_KEY="your_ark_api_key"
$env:MCP_TRANSPORT="http"
$env:MCP_HTTP_HOST="0.0.0.0"
$env:MCP_HTTP_PORT="3000"
$env:MCP_HTTP_PATH="/mcp"
node build/index.js服务启动后地址示例:
http://127.0.0.1:3000/mcpMCP 客户端接入
本地命令方式(stdio)
{
"mcpServers": {
"jimenggen": {
"command": "node",
"args": [
"/path/to/jimenggen-mcp/build/index.js"
],
"env": {
"ARK_API_KEY": "your_ark_api_key",
"MCP_TRANSPORT": "stdio"
}
}
}
}远程地址方式(http)
不同客户端配置字段可能不同,核心是把 MCP 服务地址指向:
http://your-host:3000/mcp工具列表
可用工具
工具名 | 用途 |
| 文生图 |
| 图生图 |
| 通用图片生成/编辑(支持 URL 与上传文件) |
| 直接调用 Seedream API 生成图片 |
| 视频生成(异步任务,内置轮询) |
停用工具
generate-digital-humanaction-imitationimage-dressing
模型清单
Seedream(图片)
doubao-seedream-5-0-lite-260128(默认)doubao-seedream-5-0-260128doubao-seedream-4-5-251128doubao-seedream-4-0-250828
Seedance(视频)
doubao-seedance-1-5-pro-251215(默认)doubao-seedance-1-0-pro-250528doubao-seedance-1-0-pro-fast-251015doubao-seedance-1-0-lite-t2v-250428doubao-seedance-1-0-lite-i2v-250428
视频生成(generate-video)
generate-video 使用异步任务流程:
创建任务:
POST /contents/generations/tasks查询任务:
GET /contents/generations/tasks/{id}成功后读取:
content.video_url
任务状态:
queuedrunningsucceededfailedexpired
主要参数:
参数 | 类型 | 说明 |
| string | 必填,视频提示词 |
| string | 可选,默认 |
|
| 可选,默认 |
| enum | 可选: |
| string | 可选,首帧图 URL(图生视频) |
| boolean | 可选,默认 |
| boolean | 可选,默认 |
| string | 可选,任务状态回调地址 |
| number | 可选,默认 |
| number | 可选,默认 |
兼容参数映射:
frames=121映射为duration=5frames=241映射为duration=10aspect_ratio在值合法时映射到ratio
说明:根据官方文档,Seedance 2.0 当前仅支持控制台体验,暂不支持 API 调用。
常见问题
1. 报错:未设置 ARK_API_KEY
请确认环境变量已设置,并且启动进程能读取该变量。
2. http 模式返回 404
请检查客户端访问路径是否与 MCP_HTTP_PATH 一致,默认是 /mcp。
3. 视频任务超时
可适当调大 max_poll_attempts,或增大 poll_interval_ms 后重试。
参考文档
Available Tools
8 toolsaction-imitationD
Ark-only 模式下不支持该工具
Inputs: referenceAction (required), targetCharacter (required), style (required).
generate-digital-humanD
Ark-only 模式下不支持该工具
Inputs: prompt (required), avatarStyle (required), emotion (required), action (required).
generate-imageC
使用火山方舟 Seedream 模型生成/编辑图片(Ark-only)
Inputs: prompt (required), ratio (required), imgUrls, uploadFiles, +3 more.
generate-img-seedream4C
直接调用火山方舟 Seedream API 生成图片(Ark-only)
Inputs: prompt (required), model, imgUrls, size.
generate-videoC
使用火山方舟 Seedance 模型生成视频(异步任务)
Inputs: prompt (required), model, duration, ratio, +8 more.
image-dressingD
Ark-only 模式下不支持该工具
Inputs: modelImageUrl, garmentImageUrl.
image-to-imageC
使用火山方舟 Seedream 模型进行图生图(Ark-only)
Inputs: prompt (required), ratio (required), imageUrl, localPath, +1 more.
text-to-imageC
使用火山方舟 Seedream 模型生成图片(Ark-only)
Inputs: prompt (required), ratio (required), style, model, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Multiple tools have unclear boundaries and overlapping purposes. For example, 'generate-image', 'generate-img-seedream4', and 'text-to-image' all appear to generate images, with only minor distinctions in implementation or input method that are not clearly differentiated in the descriptions. This ambiguity will likely cause misselection by agents.
The naming conventions are mixed but still readable. Most tools use a verb_noun pattern (e.g., 'generate-image', 'generate-video'), but there are deviations like 'image-dressing' and 'action-imitation' that use noun_verb or other structures. While not chaotic, the inconsistency reduces predictability.
With 8 tools, the count is reasonable and well-scoped for a media generation server focused on images and videos. It covers key operations without being overly heavy, though some tools might be redundant, which is addressed in other dimensions.
There are significant gaps in the tool surface for the domain of digital media generation. The server lacks essential operations such as editing or deleting generated content, managing tasks (e.g., checking video generation status), or handling errors. Additionally, three tools are marked as unsupported in the current mode, further limiting functionality.
Maintenance
Related MCP Connectors
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Generate video, images, speech and music with 120+ AI models and render TSX videos to MP4
Create images and videos from prompts, with options for image mixing, reference images, and start/…
AI video generation MCP server for Kling, MiniMax, Luma & Hunyuan with prompt blueprints.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI image generation through Volcano Engine's Seedream 4.0 API, supporting text-to-image, image-to-image, multi-image fusion, and sequential generation with automatic local saving and Markdown support.5239 PyPI26MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI image generation using Volcano Engine's Seedream 4.0 API with text-to-image, image-to-image, multi-image fusion capabilities, built-in prompt templates, and automatic cloud storage integration.19MIT
- AlicenseAqualityDmaintenanceEnables AI image generation using Doubao Seedream models and video generation using Doubao Seedance models through Volcano Engine's API, supporting text-to-image, image-to-image, text-to-video, and task status queries.342 npm4MIT
- AlicenseNot gradedqualityDmaintenanceAI-powered image and video generation and processing server that supports text-to-image, image-to-image, text/image-to-video generation, image analysis, and comprehensive editing operations (crop, resize, convert, adjust) through providers like Doubao and Aliyun.11 PyPI6MIT