kairouter-mcp

MCP サーバーは、KaiRouter の動画生成 API（BytePlus Seedance ファミリー（Seedance 2.0、2.0 Fast、2.0 Mini、1.5 Pro、1.0 Pro、...）および KaiRouter 上で有効な他の動画モデル）を、MCP 互換のエージェントハーネス（Claude Code、Codex、Antigravity、...）が呼び出せるツールとして公開します。

これはスタンドアロンのリポジトリです。KaiRouter のバックエンドソースは一切含まれておらず、公開/ユーザースコープの HTTP API に対するシンクライアントのみを提供します。まだ npm には公開されていません。今のところはローカルビルドから実行してください（下記参照）。

ツール

generate_video は設計上非同期です。BytePlus の動画生成には数十秒から数分かかることがあります。エージェントは generate_video を一度呼び出し、その後ジョブが完了するまで数秒ごとに check_video_status をポーリングすることが想定されています。

Related MCP server: mcp-litmedia

セットアップ

git clone https://github.com/X-OR-Cloud/kairouter-mcp.git
cd kairouter-mcp
npm install
npm run build

これにより dist/index.js が生成されます。KaiRouter の API キーが必要です。https://kairouter.com/dashboard/api-keys で作成してください。

Claude Code

claude mcp add kairouter -e KAIROUTER_API_KEY=sk-xor-your-key-here -- node /absolute/path/to/kairouter-mcp/dist/index.js

または、.mcp.json（プロジェクト） / ~/.claude.json（ユーザー）に直接追加します：

{
  "mcpServers": {
    "kairouter": {
      "command": "node",
      "args": ["/absolute/path/to/kairouter-mcp/dist/index.js"],
      "env": { "KAIROUTER_API_KEY": "sk-xor-your-key-here" }
    }
  }
}

Codex CLI

~/.codex/config.toml に追加します：

[mcp_servers.kairouter]
command = "node"
args = ["/absolute/path/to/kairouter-mcp/dist/index.js"]
env = { KAIROUTER_API_KEY = "sk-xor-your-key-here" }

Antigravity / その他の MCP 互換ハーネス

ほとんどのハーネスは、上記の Claude Code の項で示したものと同じ mcpServers JSON ブロックを受け入れます。正確な設定ファイルのパス/UI はハーネスごとに異なり、ここでは Antigravity について特に検証していないため、各ハーネスの MCP 設定を確認してください。

設定

開発

npm run dev    # tsc --watch
npm start      # run the built server directly over stdio (for manual testing with an MCP client)