Seedance 2.5 MCP

English | 简体中文

A Python MCP 2.x server for Volcano Ark Seedance 2.5. It exposes video generation and private asset library operations over SSE.

Features

Video Generation

• Text-to-video, first-frame, and first/last-frame generation

• Multimodal references using images, videos, and audio

• Video editing and extension

• Create, inspect, wait for, list, cancel, and delete generation tasks

• 480p, 720p, and 1080p output

• Fixed durations from 4 to 30 seconds or automatic duration

• Synchronized audio, MP4/MOV output, last-frame return, and web search

Private Asset Library

• Create, inspect, update, and delete asset groups

• Upload image, video, and audio assets

• Poll asset processing until the asset becomes Active

• Reference approved assets as asset://<AssetId> in Seedance requests

• Explicit confirm=true protection for destructive tools

Related MCP server: seedance-2-mcp

Requirements

• Python 3.12.3 or later

• uv

• Seedance 2.5 enabled in Volcano Ark

• IAM permissions and asset library authorization when using private assets

Environment Variables

Create the local environment file:

cp .env-example .env

Configure the credentials:

ARK_API_KEY=
VOLCENGINE_ACCESS_KEY=
VOLCENGINE_SECRET_KEY=
VOLCENGINE_SESSION_TOKEN=

A long-lived AK/SK pair does not require a session token. Never commit .env or share its contents.

Custom Model or Inference Endpoint

The default model identifier is defined near the top of src/seedance_mcp/server.py:

MODEL_ID = "doubao-seedance-2-5-260628"

You may replace it with your own Seedance 2.5 inference endpoint ID:

MODEL_ID = "ep-your-seedance-2-5-endpoint-id"

The recommended approach is to leave the source unchanged and add the optional ARK_MODEL variable to .env:

ARK_MODEL=ep-your-seedance-2-5-endpoint-id

ARK_MODEL takes precedence over MODEL_ID. If it is absent or empty, the server uses MODEL_ID. Restart the MCP server after changing either value.

Install and Run

cd /path/to/seedance-mcp
uv sync
uv run seedance-mcp

The SSE endpoint is available at:

http://127.0.0.1:8000/sse

Custom Host and Port

The listening address and port are configurable. The defaults are 127.0.0.1 and 8000. Add these optional variables to .env to override them:

MCP_HOST=0.0.0.0
MCP_PORT=9000

After changing them, restart the server. With the example above:

• Local clients connect to http://127.0.0.1:9000/sse.

• Remote clients connect to http://<server-ip-or-domain>:9000/sse.

• 0.0.0.0 is a bind address and must not be used as the client URL.

Listening on 0.0.0.0 exposes the MCP service to the network. Restrict access with a firewall or security group and use an authenticated HTTPS reverse proxy for public deployments.

Press Ctrl+C in the server terminal to stop it. After changing code or .env, restart it with:

pid=$(lsof -tiTCP:8000 -sTCP:LISTEN)
[ -n "$pid" ] && kill "$pid"
uv run seedance-mcp

MCP Client Configuration

Add the server to your MCP client's mcp_settings.json:

{
  "mcpServers": {
    "seedance-2.5": {
      "url": "http://127.0.0.1:8000/sse",
      "type": "sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Restart the MCP server or reload the editor window after changing this configuration.

MCP Tools

Video Tasks

Asset Groups

Assets

Asset uploads accept public HTTP/HTTPS URLs only. Local file paths and Base64 payloads are not supported. An asset must be Active before it can be used for video generation.

Project Structure

seedance-mcp/
├── .env-example
├── main.py
├── pyproject.toml
├── src/seedance_mcp/
│   ├── client.py
│   ├── config.py
│   └── server.py
└── uv.lock

• server.py: MCP server, video tools, asset signing, and asset tools

• client.py: Volcano Ark video generation API client

• config.py: environment-based configuration

• main.py: compatibility entry point

Important Notes

• Video generation requests incur Volcano Ark usage charges.

• Generated video URLs are typically retained for 24 hours. Download or transfer results promptly.

• Asset query URLs are temporary and remain valid for 12 hours.

• Asset and asset-group deletion is irreversible.

• Temporary AK/SK credentials and session tokens expire and must be refreshed.

Official Documentation

• Create a video generation task

• Private virtual-character asset library