OrcaRouter MCP Server

Offizieller MCP-Server für das OrcaRouter LLM-Gateway.

Durchstöbere den Modellkatalog von [OrcaRouter](https://www.orcarouter.ai) und führe Chat-Completions direkt aus jedem [Model Context Protocol](https://modelcontextprotocol.io)-Client aus — Claude Desktop, Claude Code, Cursor, Windsurf, Zed oder allem anderen, das das Protokoll spricht. Das Durchstöbern des Katalogs funktioniert **ohne API-Schlüssel** — vergleiche Preise und Fähigkeiten, bevor du dich registrierst. ## Was du tun kannst - 🗺️ Provider und Modelle ohne API-Schlüssel entdecken - 💬 Chat-Completions über jedes bereitgestellte Modell ausführen - 🧠 Anfragen automatisch über den `orcarouter/auto`-Router deines Workspaces leiten (Strategien: cost / quality / balanced / LinUCB / gated-adaptive) - 🔁 Fallback-Ketten konfigurieren (primär + bis zu 4 Fallbacks) für mehr Robustheit - 📊 Modelle serverseitig nach Provider, Fähigkeit oder Mindest-Kontextfenster filtern - 🎯 Detaillierte Modellkarten einsehen: Preise, Kontext, Latenz, unterstützte Endpunkte - 🔌 Funktioniert mit Claude Desktop, Claude Code, Cursor, Windsurf, Zed und jedem MCP-Client ## Beispiele Versuche zum Beispiel solche Eingaben: - *"Liste alle Provider auf OrcaRouter"* - *"Zeig mir alle Anthropic-Modelle mit ihren Preisen"* - *"Hol Details zu `minimax/minimax-m2.7`"* - *"Chatte mit `orcarouter/auto` und erkläre Quantencomputing"* ## Schnellstart ### Claude Code (CLI-Einzeiler) ```bash claude mcp add orcarouter -s user \ -e ORCAROUTER_API_KEY=sk-orca-your-key \ -- npx -y @orcarouter/mcp ``` ### Andere Clients (Konfigurationsdatei-Pfad) 1. Kopiere die Beispielkonfiguration für deinen MCP-Client in die Konfigurationsdatei des Clients: | Client | Beispiel | Aktion | | --------------- | --------------------------------------------------- | --------- | | Claude Desktop | [claude-desktop.json](examples/claude-desktop.json) | Ersetzen | | Claude Code | [claude-code.json](examples/claude-code.json) | Mergen | | Cursor | [cursor.json](examples/cursor.json) | Ersetzen | | Windsurf | [windsurf.json](examples/windsurf.json) | Ersetzen | Siehe [`examples/README.md`](examples/README.md) für die Pfade der Konfigurationsdateien sowie Hinweise zu Zed und anderen Clients. 2. Ersetze `sk-or-...` in der kopierten Datei durch deinen [OrcaRouter API-Schlüssel](https://www.orcarouter.ai/console). 3. Starte deinen MCP-Client neu. Die [`.mcp.json`](.mcp.json) im Stammverzeichnis enthält dieselbe Konfiguration am Standardort von [Open Plugins](https://open-plugins.com), sodass Registry- und Discovery-Tools, die danach suchen (z. B. [cursor.directory](https://cursor.directory)), diesen Server automatisch erkennen können. Erfordert Node.js 18 oder höher. Die Umgebungsvariable `ORCAROUTER_API_KEY` wird nur für `orcarouter_chat` benötigt; die Katalog-Tools funktionieren auch ohne sie. ## Tools - `orcarouter_chat` — eine Chat-Completion ausführen (mit optionaler Fallback-Kette) - `orcarouter_models_list` — den Katalog durchstöbern (Preise, Kontext, Fähigkeiten) - `orcarouter_model_card` — detaillierte Informationen zu einem Modell - `orcarouter_providers_list` — Provider mit Modellanzahl auflisten Die vollständigen Eingabeschemata werden zur Laufzeit über die MCP-Methode `tools/list` bereitgestellt — dein MCP-Client (Claude Desktop, Cursor usw.) liest sie automatisch. ## Konfiguration | Name | Erforderlich | Beschreibung | | --------------------------- | ------------ | --------------------------------------------------------- | | `ORCAROUTER_API_KEY` | optional | OrcaRouter API-Schlüssel. Nur für `orcarouter_chat` erforderlich. | | `ORCAROUTER_BASE_URL` | optional | API-Basis-URL. Standard ist `https://api.orcarouter.ai`. | | `ORCAROUTER_REQUEST_TIMEOUT`| optional | HTTP-Timeout pro Anfrage in **Sekunden**. Standard ist `300`. | ## Sicherheit API-Schlüssel werden aus Umgebungsvariablen gelesen, niemals geloggt und ausschließlich an die OrcaRouter-API gesendet. Siehe [SECURITY.md](SECURITY.md) für die Richtlinie zur Offenlegung von Schwachstellen. ## Entwicklung ```sh # 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 ``` Der Build erzeugt ein ESM-Bundle unter `dist/index.js` mit einem `#!/usr/bin/env node`-Shebang, ausführbar als `orcarouter-mcp`-Binary. ## Mitwirken Siehe [CONTRIBUTING.md](CONTRIBUTING.md). Für einsteigerfreundliche Aufgaben durchsuche das [`good first issue`](https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/labels/good%20first%20issue)-Label. ## Lizenz [MIT](LICENSE)