OrcaRouter

Servidor MCP de OrcaRouter

Servidor MCP oficial para la puerta de enlace LLM de OrcaRouter.

English | 日本語 | 中文 | 한국어 | Deutsch | Français | Español | Italiano | Русский | Português | Tiếng Việt | हिन्दी

Explora el catálogo de modelos de OrcaRouter y ejecuta completaciones de chat desde cualquier cliente Model Context Protocol — Claude Desktop, Claude Code, Cursor, Windsurf, Zed, o cualquier otra cosa que hable el protocolo.

La exploración del catálogo funciona sin una clave de API — compara precios y capacidades antes de registrarte.

Lo que puedes hacer

• 🗺️ Descubre proveedores y modelos sin una clave de API
• 💬 Ejecuta completaciones de chat a través de cualquier modelo servido
• 🧠 Enruta automáticamente las solicitudes a través del enrutador orcarouter/auto de tu espacio de trabajo (estrategias: cost / quality / balanced / LinUCB / gated-adaptive)
• 🔁 Configura cadenas de respaldo (primario + hasta 4 respaldos) para resiliencia
• 📊 Filtra modelos en el servidor por proveedor, capacidad o ventana de contexto mínima
• 🎯 Inspecciona tarjetas de modelo detalladas: precios, contexto, latencia, endpoints compatibles
• 🔌 Funciona con Claude Desktop, Claude Code, Cursor, Windsurf, Zed y cualquier cliente MCP

Ejemplos

Prueba decir cosas como:

• "Lista todos los proveedores en OrcaRouter"
• "Muéstrame todos los modelos de Anthropic con sus precios"
• "Obtén detalles sobre minimax/minimax-m2.7"
• "Chatea con orcarouter/auto y explica la computación cuántica"

Inicio rápido

Claude Code (comando de una línea)

claude mcp add orcarouter -s user \
  -e ORCAROUTER_API_KEY=sk-orca-your-key \
  -- npx -y @orcarouter/mcp

Otros clientes (ruta de archivo de configuración)

1. Copia la configuración de ejemplo para tu cliente MCP en el archivo de configuración del cliente:

   Cliente	Ejemplo	Acción
   Claude Desktop	claude-desktop.json	Reemplazar
   Claude Code	claude-code.json	Combinar
   Cursor	cursor.json	Reemplazar
   Windsurf	windsurf.json	Reemplazar

   Consulta examples/README.md para las rutas de los archivos de configuración y notas sobre Zed y otros clientes.

2. Reemplaza sk-or-... en el archivo copiado con tu clave de API de OrcaRouter.

3. Reinicia tu cliente MCP.

La raíz .mcp.json es la misma configuración en la ubicación estándar de Open Plugins, por lo que las herramientas de registro/detección que la buscan (por ejemplo, cursor.directory) pueden detectar este servidor automáticamente.

Requiere Node.js 18 o posterior. La variable de entorno ORCAROUTER_API_KEY solo es necesaria para orcarouter_chat; las herramientas de catálogo funcionan sin ella.

Herramientas

• orcarouter_chat — ejecuta una completación de chat (con cadena de respaldo opcional)
• orcarouter_models_list — explora el catálogo (precios, contexto, capacidades)
• orcarouter_model_card — información detallada de un modelo
• orcarouter_providers_list — lista proveedores con recuentos de modelos

Los esquemas de entrada completos se exponen en tiempo de ejecución mediante el método tools/list de MCP — tu cliente MCP (Claude Desktop, Cursor, etc.) los lee automáticamente.

Configuración

Nombre	Requerido	Descripción
ORCAROUTER_API_KEY	opcional	Clave de API de OrcaRouter. Solo se requiere para orcarouter_chat.
ORCAROUTER_BASE_URL	opcional	URL base de la API. Por defecto es https://api.orcarouter.ai.
ORCAROUTER_REQUEST_TIMEOUT	opcional	Tiempo de espera HTTP por solicitud en segundos. Por defecto es 300.

Seguridad

Las claves de API se leen de variables de entorno, nunca se registran y solo se envían a la API de OrcaRouter. Consulta SECURITY.md para la política de divulgación de vulnerabilidades.

Desarrollo

# bun (preferred)
bun install
bun run test
bun run typecheck
bun run build

# or with npm
npm install
npm test
npm run typecheck
npm run build

La compilación produce un paquete ESM en dist/index.js con un shebang #!/usr/bin/env node, ejecutable como el binario orcarouter-mcp.

Contribuciones

Consulta CONTRIBUTING.md. Para tareas aptas para principiantes, explora la etiqueta good first issue.

Licencia

MIT