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:

3. Build the project:

Configuration

Set the required environment variable:

Usage

Running the server

Development mode

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

MCP Client Configuration

Add this server to your MCP client configuration:

Error Handling

The server provides comprehensive error handling for:

• Invalid API keys

• Rate limiting

• Invalid parameters

• Network errors

• API response errors

License

MIT