SeedanceMCP

{
 "mcpServers": {
 "seedance": {
 "type": "streamable-http",
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

{
 "mcpServers": {
 "seedance": {
 "type": "streamable-http",
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

{
 "servers": {
 "seedance": {
 "type": "streamable-http",
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

{
 "mcpServers": {
 "seedance": {
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

claude mcp add seedance --transport http https://seedance.mcp.acedata.cloud/mcp \
 -h "Authorization: Bearer YOUR_API_TOKEN"

{
 "mcpServers": {
 "seedance": {
 "type": "streamable-http",
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

{
 "mcpServers": {
 "seedance": {
 "type": "streamable-http",
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

{
 "mcpServers": {
 "seedance": {
 "type": "streamable-http",
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

{
 "mcpServers": {
 "seedance": {
 "type": "streamable-http",
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
}

mcpServers:
 - name: seedance
 type: streamable-http
 url: https://seedance.mcp.acedata.cloud/mcp
 headers:
 Authorization: "Bearer YOUR_API_TOKEN"

{
 "language_models": {
 "mcp_servers": {
 "seedance": {
 "url": "https://seedance.mcp.acedata.cloud/mcp",
 "headers": {
 "Authorization": "Bearer YOUR_API_TOKEN"
 }
 }
 }
 }
}

# Health check (no auth required)
curl https://seedance.mcp.acedata.cloud/health

# MCP initialize
curl -X POST https://seedance.mcp.acedata.cloud/mcp \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer YOUR_API_TOKEN" \
 -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# Install from PyPI
pip install mcp-seedance
# or
uvx mcp-seedance

# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"

# Run (stdio mode for Claude Desktop / local clients)
mcp-seedance

# Run (HTTP mode for remote access)
mcp-seedance --transport http --port 8000

{
 "mcpServers": {
 "seedance": {
 "command": "uvx",
 "args": ["mcp-seedance"],
 "env": {
 "ACEDATACLOUD_API_TOKEN": "your_token_here"
 }
 }
 }
}

docker pull ghcr.io/acedatacloud/mcp-seedance:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-seedance:latest

User: Create a video of a cat playing with a ball of yarn

Claude: I'll generate a video for you.
[Calls seedance_generate_video with prompt="A cute cat playfully batting a ball of yarn"]

User: Turn this image into a video: https://example.com/landscape.jpg

Claude: I'll create a video from your image.
[Calls seedance_generate_video_from_image with first_frame_url and appropriate prompt]

User: Create a video of rain falling with sound

Claude: I'll generate a video with synchronized audio.
[Calls seedance_generate_video with prompt="Rain falling on a quiet street" and generate_audio=True, model="doubao-seedance-1-5-pro-251215"]

mcp-seedance --help

Options:
 --version Show version
 --transport Transport mode: stdio (default) or http
 --port Port for HTTP transport (default: 8000)

# Clone repository
git clone https://github.com/AceDataCloud/SeedanceMCP.git
cd SeedanceMCP

# Create virtual environment
python -m venv .venv
source .venv/bin/activate # or `.venv\Scripts\activate` on Windows

# Install with dev dependencies
pip install -e ".[dev,test]"

# Run unit tests
pytest

# Run with coverage
pytest --cov=core --cov=tools

# Run integration tests (requires API token)
pytest tests/test_integration.py -m integration

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy core tools

# Install build dependencies
pip install -e ".[release]"

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

SeedanceMCP/
├── core/ # Core modules
│ ├── __init__.py
│ ├── client.py # HTTP client for Seedance API
│ ├── config.py # Configuration management
│ ├── exceptions.py # Custom exceptions
│ ├── server.py # MCP server initialization
│ ├── types.py # Type definitions
│ └── utils.py # Utility functions
├── tools/ # MCP tool definitions
│ ├── __init__.py
│ ├── video_tools.py # Video generation tools
│ ├── task_tools.py # Task query tools
│ └── info_tools.py # Information tools
├── prompts/ # MCP prompts
│ └── __init__.py # Prompt templates
├── tests/ # Test suite
│ ├── conftest.py
│ ├── test_client.py
│ ├── test_config.py
│ ├── test_integration.py
│ └── test_utils.py
├── deploy/ # Deployment configs
│ └── production/
│ ├── deployment.yaml
│ ├── ingress.yaml
│ └── service.yaml
├── .env.example # Environment template
├── .gitignore
├── CHANGELOG.md
├── Dockerfile # Docker image for HTTP mode
├── docker-compose.yaml # Docker Compose config
├── LICENSE
├── main.py # Entry point
├── pyproject.toml # Project configuration
└── README.md