npm volcengine-mcpstdioMITupdated 5mo ago
MCP server for ByteDance Volcano Engine. Enables text generation, multi-turn chat, and embeddings via Doubao LLM models through the Volcano Ark API.
Was kannst du mit volcengine machen?
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
Installation
volcengine zu deinem Client hinzufügen. Wähl den, den du nutzt.
claude mcp add volcengine-mcp -- npx -y volcengine-mcpcodex mcp add volcengine-mcp -- npx -y volcengine-mcpamp mcp add volcengine-mcp -- npx -y volcengine-mcp{
"mcpServers": {
"volcengine-mcp": {
"command": "npx",
"args": [
"-y",
"volcengine-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"volcengine-mcp": {
"command": "npx",
"args": [
"-y",
"volcengine-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"volcengine-mcp","command":"npx","args":["-y","volcengine-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"volcengine-mcp": {
"command": "npx",
"args": [
"-y",
"volcengine-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"volcengine-mcp": {
"command": "npx",
"args": [
"-y",
"volcengine-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"volcengine-mcp": {
"command": "npx",
"args": [
"-y",
"volcengine-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"volcengine-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"volcengine-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"volcengine-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"volcengine-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y volcengine-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
4 Tools
volcengine stellt einem verbundenen Agent 4 Tools bereit.
- 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
Score
66 / 100
Gut
- Dokumentation22/25
- Pflege13/25
- Vertrauen13/20
- Funktionsumfang6/15
- Installation12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 168 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 4 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Versionsverlauf
| Versionen | Veröffentlicht |
|---|---|
| 1.0.1Aktuell | 14. Feb. 2026 |