{
  "markdown": "# volcengine-mcp\n\n[\\![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[\\![MCP](https://img.shields.io/badge/MCP-Compatible-blue.svg)](https://modelcontextprotocol.io)\n[\\![Node.js](https://img.shields.io/badge/Node.js-18%2B-green.svg)](https://nodejs.org)\n\nMCP server for ByteDance Volcano Engine. Enables text generation, multi-turn chat, and embeddings via Doubao LLM models through the Volcano Ark API.\n\n## Tools (4 total)\n\n| Tool | Description |\n|------|-------------|\n| `doubao_generate` | Generate text using Doubao models (single-turn completion) |\n| `doubao_chat` | Multi-turn conversation with message history |\n| `doubao_embeddings` | Generate text embeddings for semantic search and RAG |\n| `doubao_list_models` | List available Doubao chat and embedding models |\n\n## Available Models\n\n### Chat Models\n\n| Model ID | Context | Description |\n|----------|---------|-------------|\n| `doubao-pro-32k` | 32K | General purpose, large context |\n| `doubao-pro-4k` | 4K | General purpose, fast |\n| `doubao-lite-32k` | 32K | Lightweight, large context |\n| `doubao-lite-4k` | 4K | Lightweight, fast |\n| `doubao-seed-1-6-250615` | 32K | Latest with vision support |\n| `doubao-seed-1-6-flash-250615` | 32K | Fast thinking, low latency |\n| `doubao-seed-1-6-thinking-250615` | 32K | Deep reasoning for complex tasks |\n\n### Embedding Models\n\n| Model ID | Dimensions | Description |\n|----------|------------|-------------|\n| `doubao-embedding` | 2560 | Text embeddings |\n| `doubao-embedding-text-240715` | 2560 | Latest text embeddings |\n\n## Install\n\n```bash\nnpm install\n```\n\n## Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"volcengine\": {\n      \"type\": \"stdio\",\n      \"command\": \"node\",\n      \"args\": [\"/path/to/volcengine-mcp/index.js\"],\n      \"env\": {\n        \"ARK_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `ARK_API_KEY` | Volcano Ark API key | Yes |\n| `VOLCENGINE_API_KEY` | Alternative API key variable | Yes (if ARK_API_KEY not set) |\n| `ARK_BASE_URL` | API base URL | No (defaults to Beijing endpoint) |\n| `ARK_CHAT_MODEL` | Default chat model | No (defaults to doubao-pro-32k) |\n| `ARK_EMBEDDING_MODEL` | Default embedding model | No (defaults to doubao-embedding) |\n\n## Getting an API Key\n\n1. Sign up at [console.volcengine.com](https://console.volcengine.com)\n2. Complete real-name authentication (required for Chinese cloud services)\n3. Navigate to **Large Models** > **Volcano Ark** > **API Key Management**\n4. Create and copy your API key\n\n## Use Cases\n\n- **Chinese language tasks** -- Doubao excels at Chinese NLP\n- **Low-latency inference** -- Doubao Flash for real-time applications\n- **Deep reasoning** -- Doubao Thinking for complex analysis\n- **Cost-effective bulk processing** -- Doubao Lite for high-volume tasks\n- **Semantic search and RAG** -- Doubao embeddings (2560 dimensions)\n\n## Dependencies\n\n- `@modelcontextprotocol/sdk` -- MCP protocol SDK\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 3063,
  "sha": "e3cb6a4307e00be3a652b8aa864a7dbda8f7c8e8fe0225bcfeca0333aac68f4a",
  "repo_slug": "expertvagabond/volcengine-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_expertvagabond_volcengine_96eca1cb/readme"
}