volcengine

volcengine-mcp

[!License: MIT](https://opensource.org/licenses/MIT) [!MCP](https://modelcontextprotocol.io) [!Node.js](https://nodejs.org)

ByteDance Volcano Engine 用の MCP サーバーです。Volcano Ark API を通じて、Doubao LLM モデルによるテキスト生成、複数ターンのチャット、埋め込みを利用できます。

ツール（合計4個）

ツール	説明
doubao_generate	Doubao モデルでテキストを生成します（単一ターンの補完）
doubao_chat	メッセージ履歴を使った複数ターンの会話
doubao_embeddings	セマンティック検索と RAG 用のテキスト埋め込みを生成します
doubao_list_models	利用可能な Doubao チャットモデルと埋め込みモデルを一覧表示します

利用可能なモデル

チャットモデル

モデル ID	コンテキスト	説明
doubao-pro-32k	32K	汎用、大きなコンテキスト
doubao-pro-4k	4K	汎用、高速
doubao-lite-32k	32K	軽量、大きなコンテキスト
doubao-lite-4k	4K	軽量、高速
doubao-seed-1-6-250615	32K	ビジョン対応の最新モデル
doubao-seed-1-6-flash-250615	32K	高速な思考、低レイテンシ
doubao-seed-1-6-thinking-250615	32K	複雑なタスク向けの深い推論

埋め込みモデル

モデル ID	次元数	説明
doubao-embedding	2560	テキスト埋め込み
doubao-embedding-text-240715	2560	最新のテキスト埋め込み

インストール

npm install

設定

{
  "mcpServers": {
    "volcengine": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/volcengine-mcp/index.js"],
      "env": {
        "ARK_API_KEY": "your-api-key"
      }
    }
  }
}

環境変数

変数	説明	必須
ARK_API_KEY	Volcano Ark API キー	はい
VOLCENGINE_API_KEY	代替の API キー変数	はい（ARK_API_KEY が設定されていない場合）
ARK_BASE_URL	API ベース URL	いいえ（デフォルトは北京エンドポイント）
ARK_CHAT_MODEL	デフォルトのチャットモデル	いいえ（デフォルトは doubao-pro-32k）
ARK_EMBEDDING_MODEL	デフォルトの埋め込みモデル	いいえ（デフォルトは doubao-embedding）

API キーの取得

1. console.volcengine.com でアカウントを登録します
2. 実名認証を完了します（中国のクラウドサービスでは必須です）
3. Large Models > Volcano Ark > API Key Management に移動します
4. API キーを作成してコピーします

ユースケース

• 中国語のタスク -- Doubao は中国語 NLP に優れています
• 低レイテンシの推論 -- リアルタイムアプリケーションには Doubao Flash
• 深い推論 -- 複雑な分析には Doubao Thinking
• 費用対効果の高い大量処理 -- 大量のタスクには Doubao Lite
• セマンティック検索と RAG -- Doubao の埋め込み（2560 次元）

依存関係

• @modelcontextprotocol/sdk -- MCP プロトコル SDK

ライセンス

MIT