Summary
Connects Claude to ByteDance's Volcano Engine (Doubao) LLM platform through the Ark API. You get four tools: single-turn text generation, multi-turn chat with history, text embeddings for semantic search, and model listing. Ships with access to Doubao Pro, Lite, and Seed model families, including specialized variants like Flash for low latency and Thinking for complex reasoning. The embedding models output 2560-dimensional vectors. Requires a Volcano Ark API key and real-name authentication since it's a Chinese cloud service. Reach for this when you need Chinese language processing, want cost-effective alternatives to Western LLMs, or are building RAG systems that need high-quality Chinese embeddings.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →volcengine-mcp
[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!Node.js](https://nodejs.org)
MCP server for ByteDance Volcano Engine. Enables text generation, multi-turn chat, and embeddings via Doubao LLM models through the Volcano Ark API.
Tools (4 total)
| Tool | Description |
|---|---|
doubao_generate | Generate text using Doubao models (single-turn completion) |
doubao_chat | Multi-turn conversation with message history |
doubao_embeddings | Generate text embeddings for semantic search and RAG |
doubao_list_models | List available Doubao chat and embedding models |
Available Models
Chat Models
| Model ID | Context | Description |
|---|---|---|
doubao-pro-32k | 32K | General purpose, large context |
doubao-pro-4k | 4K | General purpose, fast |
doubao-lite-32k | 32K | Lightweight, large context |
doubao-lite-4k | 4K | Lightweight, fast |
doubao-seed-1-6-250615 | 32K | Latest with vision support |
doubao-seed-1-6-flash-250615 | 32K | Fast thinking, low latency |
doubao-seed-1-6-thinking-250615 | 32K | Deep reasoning for complex tasks |
Embedding Models
| Model ID | Dimensions | Description |
|---|---|---|
doubao-embedding | 2560 | Text embeddings |
doubao-embedding-text-240715 | 2560 | Latest text embeddings |
Install
npm install
Configuration
{
"mcpServers": {
"volcengine": {
"type": "stdio",
"command": "node",
"args": ["/path/to/volcengine-mcp/index.js"],
"env": {
"ARK_API_KEY": "your-api-key"
}
}
}
}
Environment Variables
| Variable | Description | Required |
|---|---|---|
ARK_API_KEY | Volcano Ark API key | Yes |
VOLCENGINE_API_KEY | Alternative API key variable | Yes (if ARK_API_KEY not set) |
ARK_BASE_URL | API base URL | No (defaults to Beijing endpoint) |
ARK_CHAT_MODEL | Default chat model | No (defaults to doubao-pro-32k) |
ARK_EMBEDDING_MODEL | Default embedding model | No (defaults to doubao-embedding) |
Getting an API Key
- Sign up at console.volcengine.com
- Complete real-name authentication (required for Chinese cloud services)
- Navigate to Large Models > Volcano Ark > API Key Management
- Create and copy your API key
Use Cases
- Chinese language tasks -- Doubao excels at Chinese NLP
- Low-latency inference -- Doubao Flash for real-time applications
- Deep reasoning -- Doubao Thinking for complex analysis
- Cost-effective bulk processing -- Doubao Lite for high-volume tasks
- Semantic search and RAG -- Doubao embeddings (2560 dimensions)
Dependencies
@modelcontextprotocol/sdk-- MCP protocol SDK
License
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →