Volcengine Image Generation MCP Server

A Model Context Protocol (MCP) server that provides tools for generating images using Volcengine's text-to-image API.

Features

• Text-to-image generation using Volcengine's doubao-seedream-3-0-t2i-250415 model

• Support for multiple image sizes and formats

• Configurable parameters including seed, guidance scale, and watermark

• Proper error handling and validation

• TypeScript implementation with full type safety

Installation

1. Clone or download this repository

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

Set the required environment variable:

export VOLCENGINE_API_KEY="your_api_key_here"

Usage

Running the server

npm start

Development mode

npm run dev

Available Tools

generate_image

Generate images from text prompts using Volcengine's API.

Parameters:

• prompt (required): Text description of the image to generate

• model (optional): Model ID (default: doubao-seedream-3-0-t2i-250415)

• size (optional): Image size (default: 1024x1024)

• seed (optional): Random seed for reproducible results

• guidance_scale (optional): How closely to follow the prompt (1-10)

• watermark (optional): Whether to add watermark (default: true)

• response_format (optional): Return format - 'url' or 'b64_json' (default: url)

Supported sizes:

• 1024x1024 (1:1)

• 864x1152 (3:4)

• 1152x864 (4:3)

• 1280x720 (16:9)

• 720x1280 (9:16)

• 832x1248 (2:3)

• 1248x832 (3:2)

• 1512x648 (21:9)

Example Usage

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A beautiful sunset over mountains",
    "size": "1024x1024",
    "guidance_scale": 7.5
  }
}

MCP Client Configuration

Add this server to your MCP client configuration:

{
  "mcpServers": {
    "volcengine-image": {
      "command": "node",
      "args": ["path/to/build/index.js"],
      "env": {
        "VOLCENGINE_API_KEY": "your-api-key"
      }
    }
  }
}

Error Handling

The server provides comprehensive error handling for:

• Invalid API keys

• Rate limiting

• Invalid parameters

• Network errors

• API response errors

License

MIT