volcengine-seedream-img-mcp

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