MCP server for ByteDance Seedream AI image generation
Remote endpoints: streamable-http: https://seedream.mcp.acedata.cloud/mcp
Valid MCP server (2 strong, 2 medium validity signals). 4 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
7 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Set these up before or after installing:
Environment variable: ACEDATACLOUD_API_TOKEN
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
From the project's GitHub README.
A Model Context Protocol (MCP) server for AI image generation and editing using ByteDance's Seedream models through the AceDataCloud API.
Generate and edit AI images directly from Claude, VS Code, or any MCP-compatible client.
| Tool | Description |
|---|---|
seedream_generate_image | Generate an AI image from a text prompt using ByteDance's Seedream model. |
seedream_edit_image | Edit or modify existing images using ByteDance's Seedream/SeedEdit model. |
seedream_get_task | Query the status and result of a Seedream image generation or edit task. |
seedream_get_tasks_batch | Query multiple Seedream image tasks at once. |
seedream_list_models | List all available Seedream models with their capabilities and pricing. |
seedream_list_sizes | List all available image sizes and resolution options for Seedream. |
AceDataCloud hosts a managed MCP server — no local installation required.
Endpoint: https://seedream.mcp.acedata.cloud/mcp
All requests require a Bearer token. Use the API token from Step 1.
Connect directly on Claude.ai with OAuth — no API token needed:
https://seedream.mcp.acedata.cloud/mcpAdd to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"seedream": {
"type": "streamable-http",
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to your MCP config (.cursor/mcp.json or .windsurf/mcp.json):
{
"mcpServers": {
"seedream": {
"type": "streamable-http",
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to your VS Code MCP config (.vscode/mcp.json):
{
"servers": {
"seedream": {
"type": "streamable-http",
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Or install the Ace Data Cloud MCP extension for VS Code, which bundles all 15 MCP servers with one-click setup.
{
"mcpServers": {
"seedream": {
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Claude Code supports MCP servers natively:
claude mcp add seedream --transport http https://seedream.mcp.acedata.cloud/mcp \
-h "Authorization: Bearer YOUR_API_TOKEN"
Or add to your project's .mcp.json:
{
"mcpServers": {
"seedream": {
"type": "streamable-http",
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to Cline's MCP settings (.cline/mcp_settings.json):
{
"mcpServers": {
"seedream": {
"type": "streamable-http",
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to your MCP configuration:
{
"mcpServers": {
"seedream": {
"type": "streamable-http",
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to Roo Code MCP settings:
{
"mcpServers": {
"seedream": {
"type": "streamable-http",
"url": "https://seedream.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Add to .continue/config.yaml:
mcpServers:
- name: seedream
type: streamable-http
url: https://seedream.mcp.acedata.cloud/mcp
headers:
Authorization: "Bearer YOUR_API_TOKEN"
Add to Zed's settings (~/.config/zed/settings.json):
{
"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"}}}'
If you prefer to run the server on your own machine:
# 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
Clients connect with their own Bearer token — the server extracts the token from each request's Authorization header.
| Tool | Description |
|---|---|
seedream_generate_image | Generate an image from a text prompt |
seedream_edit_image | Edit or modify existing images with AI |
| Tool | Description |
|---|---|
seedream_get_task | Query a single task status and result |
seedream_get_tasks_batch | Query multiple tasks at once |
| Tool | Description |
|---|---|
seedream_list_models | List available models with capabilities |
seedream_list_sizes | List available image size options |
| Model | Version | Type | Best For | Price |
|---|---|---|---|---|
doubao-seedream-5-0-260128 | v5.0 | Text-to-Image | Best quality, latest flagship, web search | ~$0.040/image |
doubao-seedream-4-5-251128 | v4.5 | Text-to-Image | Previous flagship, great quality | ~$0.037/image |
doubao-seedream-4-0-250828 | v4.0 | Text-to-Image | Best value, most tasks | ~$0.030/image |
doubao-seedream-3-0-t2i-250415 | v3.0 | Text-to-Image | Reproducible results | ~$0.038/image |
doubao-seededit-3-0-i2i-250628 | v3.0 | Image-to-Image | Image editing | ~$0.046/image |
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]
| Variable | Description | Default |
|---|---|---|
ACEDATACLOUD_API_TOKEN | API token from AceDataCloud | Required |
ACEDATACLOUD_API_BASE_URL | API base URL | https://api.acedata.cloud |
ACEDATACLOUD_OAUTH_CLIENT_ID | OAuth client ID (hosted mode) | — |
ACEDATACLOUD_PLATFORM_BASE_URL | Platform base URL | https://platform.acedata.cloud |
SEEDREAM_REQUEST_TIMEOUT | Request timeout in seconds | 1800 |
LOG_LEVEL | Logging level | INFO |
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
This server wraps the AceDataCloud Seedream API:
MIT License - see the LICENSE file for details.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.