kairouter-mcp

Servidor MCP que expone la API de generación de video de KaiRouter — la familia BytePlus Seedance (Seedance 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro, 1.0 Pro, ...) y cualquier otro modelo de video activo en KaiRouter — como herramientas que cualquier entorno de agente compatible con MCP (Claude Code, Codex, Antigravity, ...) puede llamar.

Este es un repositorio independiente: no contiene ningún código fuente del backend de KaiRouter, solo un cliente ligero para su API HTTP pública/por usuario. Aún no está publicado en npm; por ahora, ejecútalo desde una compilación local (ver más abajo).

Herramientas

generate_video es asíncrono por diseño: la generación de video de BytePlus puede tardar decenas de segundos o unos minutos. Se espera que el agente llame a generate_video una vez y luego consulte check_video_status cada pocos segundos hasta que el trabajo termine.

Related MCP server: mcp-litmedia

Instalación

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

Esto produce dist/index.js. Necesitarás una clave de API de KaiRouter: crea una en 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

O añade directamente a .mcp.json (proyecto) / ~/.claude.json (usuario):

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

Codex CLI

Añade a ~/.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 / otros entornos compatibles con MCP

La mayoría de los entornos aceptan el mismo bloque JSON mcpServers mostrado arriba en Claude Code; consulta la configuración MCP del propio entorno para la ruta/UI exacta del archivo de configuración, ya que esto varía y no se verificó aquí específicamente para Antigravity.

Configuración

Desarrollo

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