# volcengine-seedream-img-mcp

MCP server for [Volcengine Ark](https://www.volcengine.com/product/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`:

```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