io.github.ExpertVagabond/volcengine

Official

by ExpertVagabond · Rust

ByteDance Volcano Engine (Doubao) MCP server

ByteDance Volcano Engine (Doubao) MCP Server

This MCP server provides access to ByteDance Volcano Engine (Doubao). It enables text generation, multi-turn chat, and embeddings via Doubao LLM models using the Volcano Ark API. The server is distributed under the MIT license and is MCP-compatible.

🛠️ Key Features

ByteDance Volcano Engine (Doubao) integration
Text generation
Multi-turn chat
Embeddings
Uses the Volcano Ark API

🚀 Use Cases

Generate text with Doubao models
Run multi-turn conversations
Create embeddings for downstream AI workflows

⚡ Developer Benefits

MCP-Compatible server (“MCP-Compatible”)
Tooling support for Doubao operations (toolCount: 4)

⚠️ Limitations

Only tool details are partially shown: doubao_generate is listed, while remaining tools are not fully described in the provided excerpt.

📚 Topics

ai, mcp, model-context-protocol, tools, bytedance, chinese-ai, claude-code, doubao, embeddings, llm, volcano-engine.

Topics

aimcpmodel-context-protocoltoolsbytedancechinese-aiclaude-codedoubaoembeddingsllmvolcano-engine

README.md3 KBView on GitHub

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

bash

npm install

Configuration

json

{
  "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

MIT

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "volcengine": {
      "command": "npx",
      "args": [
        "-y",
        "volcengine-mcp@1.0.1"
      ]
    }
  }
}

ByteDance Volcano Engine (Doubao) MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

📚 Topics

Topics

volcengine-mcp

Tools (4 total)

Available Models

Chat Models

Embedding Models

Install

Configuration

Environment Variables

Getting an API Key

Use Cases

Dependencies

License

Install

Related servers