Volcano Engine MCP Server

MCP server for ByteDance Volcano Engine (Doubao) integration with Claude Code. Enables Claude to delegate tasks to ByteDance's Doubao LLM models.

Features

Text Generation - Generate text using Doubao models
Chat - Multi-turn conversations with Doubao
Embeddings - Generate text embeddings for RAG and semantic search
Model Listing - List available Doubao models

Available Tools (4 total)

Tool	Description
`doubao_generate`	Generate text using Doubao models
`doubao_chat`	Multi-turn chat with Doubao models
`doubao_embeddings`	Generate text embeddings
`doubao_list_models`	List available models

Setup

1. Get Volcano Engine API Key

Sign up at console.volcengine.com
Complete real-name authentication (required)
Navigate to: Large Models → Volcano Ark → API Key Management
Create and copy your API key

2. Install Dependencies

cd ~/mcp-servers/volcengine-mcp
npm install

3. Add to Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "volcengine": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/matthewkarsten/mcp-servers/volcengine-mcp/index.js"],
      "env": {
        "ARK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

Variable	Description	Required
`ARK_API_KEY`	Volcano Ark API key	Yes
`VOLCENGINE_API_KEY`	Alternative API key env var	Yes (if ARK_API_KEY not set)
`ARK_BASE_URL`	API base URL	No (defaults to Beijing region)
`ARK_CHAT_MODEL`	Default chat model	No (defaults to doubao-pro-32k)
`ARK_EMBEDDING_MODEL`	Default embedding model	No

Available Models

Chat Models

Model ID	Description	Context
`doubao-pro-32k`	General purpose, large context	32K
`doubao-pro-4k`	General purpose, fast	4K
`doubao-lite-32k`	Lightweight, large context	32K
`doubao-lite-4k`	Lightweight, fast	4K
`doubao-seed-1-6-250615`	Latest with vision support	32K
`doubao-seed-1-6-flash-250615`	Fast thinking, low latency	32K
`doubao-seed-1-6-thinking-250615`	Deep reasoning	32K

Embedding Models

Model ID	Description	Dimensions
`doubao-embedding`	Text embeddings	2560
`doubao-embedding-text-240715`	Latest embeddings	2560

Architecture

Claude Code (Opus 4.5)
         │
         └──▶ Volcano Engine MCP Server
                    │
                    └──▶ Volcano Ark API
                              │
                              ├── Doubao Pro Models
                              ├── Doubao Lite Models
                              ├── Doubao Seed Models
                              └── Embedding Models

Usage Examples

User: Use Doubao to write a haiku about cloud computing

Claude: [Uses doubao_generate tool]
Result:
{
  "text": "Servers hum softly\nData flows through endless clouds\nDigital rain falls",
  "model": "doubao-pro-32k",
  "usage": { "prompt_tokens": 12, "completion_tokens": 18 }
}

Pricing

ByteDance Volcano Engine offers competitive pricing:

Free tier: 500,000 tokens for individual users
Doubao Pro: ~~0.0008 CNY / 1K tokens (~~$0.0001 USD)
Doubao Lite: ~0.0003 CNY / 1K tokens

Multi-Agent Architecture

This MCP server enables a multi-agent system:

Claude Code (Opus 4.5)
         │
         ├──▶ watsonx MCP Server (IBM Granite)
         ├──▶ volcengine MCP Server (ByteDance Doubao)
         └──▶ ibmz MCP Server (Key Protect HSM)

Claude can delegate different tasks to specialized models based on:

Language: Doubao excels at Chinese language tasks
Latency: Doubao Flash for real-time applications
Reasoning: Doubao Thinking for complex analysis
Cost: Doubao Lite for high-volume tasks

Files

volcengine-mcp/
├── index.js        # MCP server implementation
├── package.json    # Dependencies
└── README.md       # This file

Dependencies

@modelcontextprotocol/sdk - MCP SDK

Author

Matthew Karsten

License

MIT

volcengine

Quick Install