kairouter-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, ...)가 호출할 수 있는 도구로 제공하는 MCP 서버입니다.

이 저장소는 독립형 저장소로, 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)