AceDataCloud/MCPSeedream

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.
Features
- **Text-to-Image Generation** — Create high-quality images from text prompts (Chinese & English)
- **Image Editing** — Modify existing images, including transparent-background Pro edits
- **Multiple Models** — Seedream v5.0 (flagship), v4.5, and v4.0
- **Layer Decomposition** — Split one image into a base plus up to 16 editable transparent PNG layers
- **Multi-Resolution** — Pro 1K/1.5K/2K; Lite 2K/3K/4K; custom dimensions
- **Sequential Generation** — Generate related images in sequence (5.0 Lite/4.5/4.0)
- **Web Search** — Let 5.0 Lite use current web information when needed
- **Task Tracking** — Monitor generation progress and retrieve results
Tool Reference
| Tool | Description |
|------|-------------|
| seedream_generate_image | Generate an AI image from a text prompt using ByteDance's Seedream model. |
| seedream_edit_image | Edit images, including Seedream 5.0 Pro transparent-background mode. |
| seedream_decompose_image | Split one image into a base and up to 16 positioned transparent layers. |
| 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. |
Seedream 5.0 capability matrix
| Capability | 5.0 Pro | 5.0 Lite |
|---|---:|---:|
| Single image generation/editing | Yes | Yes |
| Layer decomposition / transparent background | Yes | No |
| Sequential images / web search | No | Yes |
| Prompt optimization | standard, fast | standard |
| Preset sizes | 1K, 1.5K, 2K | 2K, 3K, 4K |
MCP image tools submit asynchronously and return a task id. Use seedream_get_task until completion. For real-time NDJSON streaming, call the REST API or CLI rather than combining stream with MCP async submission.
Connect: hosted OAuth, API token, or local stdio
The hosted endpoint is https://seedream.mcp.acedata.cloud/mcp. Choose one route for the MCP client:
| Route | When to use it | Credential setup |
|---|---|---|
| Hosted OAuth | The client supports remote MCP OAuth | Add only the URL, then sign in to AceDataCloud and approve access. No token needs to be pasted into client configuration. |
| Hosted API token | The client cannot finish OAuth, or you need an explicit integration credential | Send an AceDataCloud API token in the Authorization: Bearer … header. Keep it in a local secret store or environment variable. |
| Local stdio | The client runs a local MCP process | Install mcp-seedream-pro and pass ACEDATACLOUD_API_TOKEN to that process. It still calls the AceDataCloud API. |
The hosted service advertises OAuth metadata and Dynamic Client Registration (DCR). **DCR registers the client application; it is not an API key.** OAuth signs you in and the client sends the resulting Bearer token; it may reuse or create an API credential for the account. Browser sign-in still requires an AceDataCloud account. The hosted service can be metered: review current service documentation and displayed pricing before a real operation. Do not configure both an OAuth login and a fixed Authorization header for the same server.
Hosted OAuth examples
- **Claude and Claude Desktop chat:** Add a remote custom connector in Customize → Connectors → Add custom connector, enter https://seedream.mcp.acedata.cloud/mcp, select sign-in, and choose **Register automatically** if Claude asks how to register its OAuth client. Complete consent. Claude Desktop's local claude_desktop_config.json is a separate setup. Claude connector guide.