# Volcengine Mcp

> ByteDance Volcano Engine (Doubao) MCP server

- **Type:** MCP server
- **Install:** `agentstack add mcp-expertvagabond-volcengine-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ExpertVagabond](https://agentstack.voostack.com/s/expertvagabond)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 1.0.1
- **License:** MIT
- **Upstream author:** [ExpertVagabond](https://github.com/ExpertVagabond)
- **Source:** https://github.com/ExpertVagabond/volcengine-mcp
- **Website:** - Creating gist volcengine-mcp-quickstart.md
✓ Created public gist volcengine-mcp-quickstart.md
https://gist.github.com/ExpertVagabond/3a69dce5f39537b3ef327597438fda1f

## Install

```sh
agentstack add mcp-expertvagabond-volcengine-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ExpertVagabond](https://github.com/ExpertVagabond)
- **Source:** [ExpertVagabond/volcengine-mcp](https://github.com/ExpertVagabond/volcengine-mcp)
- **License:** MIT
- **Homepage:** - Creating gist volcengine-mcp-quickstart.md
✓ Created public gist volcengine-mcp-quickstart.md
https://gist.github.com/ExpertVagabond/3a69dce5f39537b3ef327597438fda1f

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-expertvagabond-volcengine-mcp
- Seller: https://agentstack.voostack.com/s/expertvagabond
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.