Jimeng MCP Server

A Model Context Protocol (MCP) server for Volcengine's Jimeng AI image generation service.

Features

• Generate images using Volcengine's Jimeng AI service

• Support for Chinese and English prompts

• Configurable image dimensions and generation parameters

• Watermark support

• Built-in prompt enhancement (LLM preprocessing)

• Super-resolution enhancement

Related MCP server: Gemini MCP Image Generation Server

Installation

npm install jimeng-mcp

Setup

1. Get your Volcengine credentials from the Volcengine Console

2. Set environment variables:

export VOLCENGINE_ACCESS_KEY_ID="your_access_key_id"
export VOLCENGINE_SECRET_ACCESS_KEY="your_secret_access_key"

Usage

With Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "jimeng": {
      "command": "npx",
      "args": ["jimeng-mcp"],
      "env": {
        "VOLCENGINE_ACCESS_KEY_ID": "your_access_key_id",
        "VOLCENGINE_SECRET_ACCESS_KEY": "your_secret_access_key"
      }
    }
  }
}

Standalone Usage

# Set environment variables
export VOLCENGINE_ACCESS_KEY_ID="your_access_key_id"
export VOLCENGINE_SECRET_ACCESS_KEY="your_secret_access_key"

# Run the server
npm start

Available Tools

generateImage

Generate images using text descriptions.

Parameters:

• prompt (required): Text description for image generation

• req_key (optional): Model identifier (default: "jimeng_high_aes_general_v21_L")

• seed (optional): Random seed for generation (default: -1)

• width (optional): Image width in pixels (default: 512)

• height (optional): Image height in pixels (default: 512)

• use_sr (optional): Enable super-resolution (default: true)

• use_pre_llm (optional): Enable prompt enhancement (default: true)

• return_url (optional): Return image URLs (default: true)

• logo_info (optional): Watermark configuration

Example:

{
  "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，高清摄影",
  "width": 1024,
  "height": 1024,
  "use_sr": true
}

Development

# Install dependencies
npm install

# Build
npm run build

# Development mode
npm run dev

# Lint
npm run lint

# Format
npm run format

Configuration

Environment Variables

• VOLCENGINE_ACCESS_KEY_ID: Your Volcengine access key ID

• VOLCENGINE_SECRET_ACCESS_KEY: Your Volcengine secret access key

Watermark Configuration

{
  "logo_info": {
    "add_logo": true,
    "position": 0,     // 0: bottom-right, 1: bottom-left, 2: top-left, 3: top-right
    "language": 0,     // 0: Chinese, 1: English
    "logo_text_content": "AI Generated",
    "opacity": 0.3
  }
}

API Reference

This MCP server interfaces with Volcengine's Jimeng image generation API. For detailed API documentation, visit:

• Jimeng API Documentation

• Volcengine Authentication

License

MIT

Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

Support

For issues and questions:

• GitHub Issues

• Volcengine Documentation

Security

• Never commit API keys or secrets to version control

• Use environment variables for sensitive configuration

• Regularly rotate your API credentials