io.github.ExpertVagabond/volcengine
ByteDance Volcano Engine (Doubao) MCP server
Open source Open in the app JSON README (API)
About
ByteDance Volcano Engine (Doubao) MCP server
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- expertvagabond
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Last push
- 2026-09-08T01:44:42Z
- Repository state
- ativo
- Language
- Rust
- License
- MIT
- Added
- 2026-08-29 03:01:54
- Updated
- 2026-08-29 03:01:54
- Origin id
io.github.ExpertVagabond/volcengine
README
# volcengine-mcp
[\](https://opensource.org/licenses/MIT)
[\](https://modelcontextprotocol.io)
[\](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
1. Sign up at [console.volcengine.com](https://console.volcengine.com)
2. Complete real-name authentication (required for Chinese cloud services)
3. Navigate to **Large Models** > **Volcano Ark** > **API Key Management**
4. 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](LICENSE)