OrcaRouter

OrcaRouter MCP Server

Servidor MCP oficial para o gateway LLM OrcaRouter.

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

Navegue pelo catálogo de modelos do OrcaRouter e execute conclusões de chat de dentro de qualquer cliente Model Context Protocol — Claude Desktop, Claude Code, Cursor, Windsurf, Zed ou qualquer outra coisa que fale o protocolo.

A navegação no catálogo funciona sem chave de API — compare preços e recursos antes de se inscrever.

O que você pode fazer

• 🗺️ Descubra provedores e modelos sem chave de API
• 💬 Execute conclusões de chat em qualquer modelo servido
• 🧠 Roteie automaticamente solicitações pelo roteador orcarouter/auto do seu workspace (estratégias de custo / qualidade / balanceado / LinUCB / adaptativo-gated)
• 🔁 Configure cadeias de fallback (primário + até 4 fallbacks) para resiliência
• 📊 Filtre modelos no servidor por provedor, capacidade ou janela de contexto mínima
• 🎯 Inspecione cartões de modelo detalhados: preços, contexto, latência, endpoints suportados
• 🔌 Funciona com Claude Desktop, Claude Code, Cursor, Windsurf, Zed e qualquer cliente MCP

Exemplos

Tente dizer coisas como:

• "Liste todos os provedores no OrcaRouter"
• "Mostre-me todos os modelos Anthropic com seus preços"
• "Obtenha detalhes sobre minimax/minimax-m2.7"
• "Converse com orcarouter/auto e explique computação quântica"

Início Rápido

Claude Code (comando de uma linha via CLI)

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

Outros clientes (caminho do arquivo de configuração)

1. Copie o exemplo de configuração para o seu cliente MCP no arquivo de configuração do cliente:

   Cliente	Exemplo	Ação
   Claude Desktop	claude-desktop.json	Substituir
   Claude Code	claude-code.json	Mesclar
   Cursor	cursor.json	Substituir
   Windsurf	windsurf.json	Substituir

   Veja examples/README.md para os caminhos dos arquivos de configuração e notas sobre Zed e outros clientes.

2. Substitua sk-or-... no arquivo copiado pela sua chave de API do OrcaRouter.

3. Reinicie seu cliente MCP.

O .mcp.json raiz é a mesma configuração no local padrão do Open Plugins, para que ferramentas de registro/descoberta que o examinam (por exemplo, cursor.directory) possam detectar este servidor automaticamente.

Requer Node.js 18 ou posterior. A variável de ambiente ORCAROUTER_API_KEY é necessária apenas para orcarouter_chat; as ferramentas de catálogo funcionam sem ela.

Ferramentas

• orcarouter_chat — execute uma conclusão de chat (com cadeia de fallback opcional)
• orcarouter_models_list — navegue pelo catálogo (preços, contexto, recursos)
• orcarouter_model_card — informações detalhadas para um modelo
• orcarouter_providers_list — liste provedores com contagens de modelos

Esquemas completos de entrada são expostos em tempo de execução via método MCP tools/list — seu cliente MCP (Claude Desktop, Cursor, etc.) os lê automaticamente.

Configuração

Nome	Obrigatório	Descrição
ORCAROUTER_API_KEY	opcional	Chave de API do OrcaRouter. Necessária apenas para orcarouter_chat.
ORCAROUTER_BASE_URL	opcional	URL base da API. Padrão: https://api.orcarouter.ai.
ORCAROUTER_REQUEST_TIMEOUT	opcional	Tempo limite HTTP por solicitação em segundos. Padrão: 300.

Segurança

As chaves de API são lidas de variáveis de ambiente, nunca registradas e enviadas apenas para a API do OrcaRouter. Veja SECURITY.md para a política de divulgação de vulnerabilidades.

Desenvolvimento

# 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

A compilação produz um pacote ESM em dist/index.js com um shebang #!/usr/bin/env node, executável como o binário orcarouter-mcp.

Contribuindo

Veja CONTRIBUTING.md. Para tarefas amigáveis para iniciantes, navegue pelo rótulo good first issue.

Licença

MIT