Skip to main content
Glama
volcengine-seedream-img-mcp

volcengine-seedream-img-mcp

by ckz

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[].

Related MCP server: Seedream 4.0 MCP Server

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

Available Tools

4 tools
edit_imageA

Edit or restyle a single reference image using a text prompt (uses doubao-seededit-3-0-i2i). Output size is adaptive to input image aspect ratio. Returns a request_id to poll with get_image_result.

Inputs: image (required), prompt (required), watermark, response_format.

generate_imageA

Generate a single image from a text prompt (text-to-image), or using 1–14 reference images (image-to-image). Returns a request_id to poll with get_image_result.

Inputs: prompt (required), image, model, watermark, +3 more.

generate_image_groupB

Generate a group of related images from a prompt and optional reference images. Returns a request_id to poll with get_image_result.

Inputs: prompt (required), image, model, watermark, +4 more.

get_image_resultA

Poll the result of a previous generate_image, edit_image, or generate_image_group call. Returns state: pending | succeeded | error.

Inputs: request_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a distinct operation: editing a single image, generating a single image, generating a group, and polling results. No overlap in purpose.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case: edit_image, generate_image, generate_image_group, get_image_result.

    Tool Count5/5

    4 tools is well-scoped for an image generation server, covering core creation, editing, and result polling without unnecessary extra tools.

    Completeness4/5

    The set covers the main workflow (generate, edit, poll), but is missing optional features like cancellation or listing pending requests, which are minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers