SeedreamMCP

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

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

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

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

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

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

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

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

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

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

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

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

# MCP initialize
curl -X POST https://seedream.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-seedream-pro
# or
uvx mcp-seedream-pro

# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"

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

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

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

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

User: Create a photorealistic image of a cat in a garden

Claude: I'll generate that image for you.
[Calls seedream_generate_image with detailed prompt]
→ Returns task_id and image URL

User: Change the background of this photo to a beach
[Provides image URL]

Claude: I'll edit that image for you.
[Calls seedream_edit_image with image URL and edit description]

User: 生成一幅中国山水画，有远山、流水和古松

Claude: 好的，我来为您生成这幅山水画。
[Calls seedream_generate_image with Chinese prompt]

User: Generate a landscape and make sure I can recreate the exact same image later

Claude: I'll use the v3 model with a fixed seed.
[Calls seedream_generate_image with model=doubao-seedream-3-0-t2i-250415, seed=42]

mcp-seedream-pro --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/SeedreamMCP.git
cd SeedreamMCP

# 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 -m integration

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy core tools main.py

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

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

SeedreamMCP/
├── core/ # Core modules
│ ├── __init__.py
│ ├── client.py # HTTP client for Seedream 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
│ ├── image_tools.py # Image generation/editing tools
│ ├── task_tools.py # Task query tools
│ └── info_tools.py # Model & size info tools
├── prompts/ # MCP prompt templates
│ └── __init__.py
├── tests/ # Test suite
│ ├── conftest.py
│ ├── test_config.py
│ └── test_utils.py
├── deploy/ # Deployment configs
│ ├── run.sh
│ └── production/
│ ├── deployment.yaml
│ ├── ingress.yaml
│ └── service.yaml
├── .github/ # GitHub Actions workflows
│ ├── dependabot.yml
│ └── workflows/
│ ├── ci.yaml
│ ├── claude.yml
│ ├── deploy.yaml
│ └── publish.yml
├── .env.example # Environment template
├── .gitignore
├── .ruff.toml # Ruff linter config
├── 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