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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →