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
Installation
npm install jimeng-mcp
Setup
- Get your Volcengine credentials from the Volcengine Console
- 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 generationreq_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 IDVOLCENGINE_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:
License
MIT
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Support
For issues and questions:
Security
- Never commit API keys or secrets to version control
- Use environment variables for sensitive configuration
- Regularly rotate your API credentials