Volcengine Seedream Img

MCP server for Volcengine Ark Doubao-Seedream image generation and editing.

Tools

Tool	Description
generate_image	Text-to-image or image-to-image (1–14 refs). Returns request_id.
edit_image	Edit/restyle a single image with a prompt (seededit-3.0). Returns request_id.
generate_image_group	Generate a group of related images. Returns request_id.
get_image_result	Poll a previous job by request_id. Returns state + images[].

Setup (Claude Code)

Add to .mcp.json:

{
  "mcpServers": {
    "seedream": {
      "command": "npx",
      "args": ["-y", "volcengine-seedream-img-mcp"],
      "env": { "ARK_API_KEY": "your_key_here" }
    }
  }
}

Auth

Set ARK_API_KEY environment variable, or pass --api-key <value> as a CLI flag.

Get your key at: https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey

Models

Model ID	Resolution support
doubao-seedream-4-0-250828	1K, 2K, 4K
doubao-seedream-4-5-251128	2K, 4K
doubao-seedream-5-0-260128	2K, 3K

1K resolution is silently upgraded to 2K when using a model that doesn't support it.

edit_image always uses doubao-seededit-3-0-i2i (model not selectable).

Workflow

generate_image / edit_image / generate_image_group
  → { request_id }
  → poll get_image_result until state = "succeeded"
  → images[].url  (download within 24h)

License

MIT