@orcarouter/mcp 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/LICENSE +21 -0
  2. package/README.de.md +118 -0
  3. package/README.es.md +126 -0
  4. package/README.fr.md +126 -0
  5. package/README.hi.md +126 -0
  6. package/README.it.md +127 -0
  7. package/README.ja.md +123 -0
  8. package/README.ko.md +118 -0
  9. package/README.md +126 -0
  10. package/README.pt.md +126 -0
  11. package/README.ru.md +126 -0
  12. package/README.vi.md +126 -0
  13. package/README.zh-CN.md +122 -0
  14. package/assets/logo.gif +0 -0
  15. package/dist/index.js +736 -0
  16. package/dist/index.js.map +1 -0
  17. package/package.json +55 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 OrcaRouter
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.de.md ADDED
@@ -0,0 +1,118 @@
1
+ <p align="center">
2
+ <a href="https://www.orcarouter.ai">
3
+ <img src="https://raw.githubusercontent.com/Continuum-AI-Corp/orcarouter-mcp-server/main/assets/logo.gif" alt="OrcaRouter" width="180" />
4
+ </a>
5
+ </p>
6
+
7
+ <h1 align="center">OrcaRouter MCP Server</h1>
8
+
9
+ <p align="center">
10
+ Offizieller MCP-Server für das <a href="https://www.orcarouter.ai">OrcaRouter</a> LLM-Gateway.
11
+ </p>
12
+
13
+ <p align="center">
14
+ <a href="https://discord.com/invite/943Zqp9bs"><img src="https://img.shields.io/discord/1501106943178309662?logo=discord&label=discord&color=5865F2" alt="Discord" /></a>
15
+ <a href="https://x.com/OrcaRouter"><img src="https://img.shields.io/badge/X-Follow-000000?logo=x&logoColor=white" alt="X" /></a>
16
+ <a href="https://www.npmjs.com/package/@orcarouter/mcp"><img src="https://img.shields.io/npm/v/@orcarouter/mcp" alt="npm version" /></a>
17
+ <a href="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml"><img src="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml/badge.svg" alt="CI" /></a>
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | <a href="README.it.md">Italiano</a> | <a href="README.ru.md">Русский</a> | <a href="README.pt.md">Português</a> | <a href="README.vi.md">Tiếng Việt</a> | <a href="README.hi.md">हिन्दी</a>
22
+ </p>
23
+
24
+ <br/>
25
+
26
+ 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.
27
+
28
+ Das Durchstöbern des Katalogs funktioniert **ohne API-Schlüssel** — vergleiche Preise und Fähigkeiten, bevor du dich registrierst.
29
+
30
+ ## Was du tun kannst
31
+
32
+ - 🗺️ Provider und Modelle ohne API-Schlüssel entdecken
33
+ - 💬 Chat-Completions über jedes bereitgestellte Modell ausführen
34
+ - 🧠 Anfragen automatisch über den `orcarouter/auto`-Router deines Workspaces leiten (Strategien: cost / quality / balanced / LinUCB / gated-adaptive)
35
+ - 🔁 Fallback-Ketten konfigurieren (primär + bis zu 4 Fallbacks) für mehr Robustheit
36
+ - 📊 Modelle serverseitig nach Provider, Fähigkeit oder Mindest-Kontextfenster filtern
37
+ - 🎯 Detaillierte Modellkarten einsehen: Preise, Kontext, Latenz, unterstützte Endpunkte
38
+ - 🔌 Funktioniert mit Claude Desktop, Claude Code, Cursor, Windsurf, Zed und jedem MCP-Client
39
+
40
+ ## Beispiele
41
+
42
+ Versuche zum Beispiel solche Eingaben:
43
+
44
+ - *"Liste alle Provider auf OrcaRouter"*
45
+ - *"Zeig mir alle Anthropic-Modelle mit ihren Preisen"*
46
+ - *"Hol Details zu `minimax/minimax-m2.7`"*
47
+ - *"Chatte mit `orcarouter/auto` und erkläre Quantencomputing"*
48
+
49
+ ## Schnellstart
50
+
51
+ ### Claude Code (CLI-Einzeiler)
52
+
53
+ ```bash
54
+ claude mcp add orcarouter -s user \
55
+ -e ORCAROUTER_API_KEY=sk-orca-your-key \
56
+ -- npx -y @orcarouter/mcp
57
+ ```
58
+
59
+ ### Andere Clients (Konfigurationsdatei-Pfad)
60
+
61
+ 1. Kopiere die Beispielkonfiguration für deinen MCP-Client in die Konfigurationsdatei des Clients:
62
+
63
+ | Client | Beispiel | Aktion |
64
+ | --------------- | --------------------------------------------------- | --------- |
65
+ | Claude Desktop | [claude-desktop.json](examples/claude-desktop.json) | Ersetzen |
66
+ | Claude Code | [claude-code.json](examples/claude-code.json) | Mergen |
67
+ | Cursor | [cursor.json](examples/cursor.json) | Ersetzen |
68
+ | Windsurf | [windsurf.json](examples/windsurf.json) | Ersetzen |
69
+
70
+ Siehe [`examples/README.md`](examples/README.md) für die Pfade der Konfigurationsdateien sowie Hinweise zu Zed und anderen Clients.
71
+
72
+ 2. Ersetze `sk-or-...` in der kopierten Datei durch deinen [OrcaRouter API-Schlüssel](https://www.orcarouter.ai/console).
73
+ 3. Starte deinen MCP-Client neu.
74
+
75
+ 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.
76
+
77
+ ## Tools
78
+
79
+ - `orcarouter_chat` — eine Chat-Completion ausführen (mit optionaler Fallback-Kette)
80
+ - `orcarouter_models_list` — den Katalog durchstöbern (Preise, Kontext, Fähigkeiten)
81
+ - `orcarouter_model_card` — detaillierte Informationen zu einem Modell
82
+ - `orcarouter_providers_list` — Provider mit Modellanzahl auflisten
83
+
84
+ Die vollständigen Eingabeschemata werden zur Laufzeit über die MCP-Methode `tools/list` bereitgestellt — dein MCP-Client (Claude Desktop, Cursor usw.) liest sie automatisch.
85
+
86
+ ## Konfiguration
87
+
88
+ | Name | Erforderlich | Beschreibung |
89
+ | --------------------------- | ------------ | --------------------------------------------------------- |
90
+ | `ORCAROUTER_API_KEY` | optional | OrcaRouter API-Schlüssel. Nur für `orcarouter_chat` erforderlich. |
91
+ | `ORCAROUTER_BASE_URL` | optional | API-Basis-URL. Standard ist `https://api.orcarouter.ai`. |
92
+ | `ORCAROUTER_REQUEST_TIMEOUT`| optional | HTTP-Timeout pro Anfrage in **Sekunden**. Standard ist `300`. |
93
+
94
+ ## Sicherheit
95
+
96
+ 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.
97
+
98
+ ## Entwicklung
99
+
100
+ ```sh
101
+ # bun (preferred)
102
+ bun install
103
+ bun run test
104
+ bun run typecheck
105
+ bun run build
106
+
107
+ # or with npm
108
+ npm install
109
+ npm test
110
+ npm run typecheck
111
+ npm run build
112
+ ```
113
+
114
+ Der Build erzeugt ein ESM-Bundle unter `dist/index.js` mit einem `#!/usr/bin/env node`-Shebang, ausführbar als `orcarouter-mcp`-Binary.
115
+
116
+ ## Lizenz
117
+
118
+ [MIT](LICENSE)
package/README.es.md ADDED
@@ -0,0 +1,126 @@
1
+ <p align="center">
2
+ <a href="https://www.orcarouter.ai">
3
+ <img src="https://raw.githubusercontent.com/Continuum-AI-Corp/orcarouter-mcp-server/main/assets/logo.gif" alt="OrcaRouter" width="180" />
4
+ </a>
5
+ </p>
6
+
7
+ <h1 align="center">OrcaRouter MCP Server</h1>
8
+
9
+ <p align="center">
10
+ Servidor MCP oficial para el gateway LLM de <a href="https://www.orcarouter.ai">OrcaRouter</a>.
11
+ </p>
12
+
13
+ <p align="center">
14
+ <a href="https://discord.com/invite/943Zqp9bs"><img src="https://img.shields.io/discord/1501106943178309662?logo=discord&label=discord&color=5865F2" alt="Discord" /></a>
15
+ <a href="https://x.com/OrcaRouter"><img src="https://img.shields.io/badge/X-Follow-000000?logo=x&logoColor=white" alt="X" /></a>
16
+ <a href="https://www.npmjs.com/package/@orcarouter/mcp"><img src="https://img.shields.io/npm/v/@orcarouter/mcp" alt="npm version" /></a>
17
+ <a href="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml"><img src="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml/badge.svg" alt="CI" /></a>
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | <a href="README.it.md">Italiano</a> | <a href="README.ru.md">Русский</a> | <a href="README.pt.md">Português</a> | <a href="README.vi.md">Tiếng Việt</a> | <a href="README.hi.md">हिन्दी</a>
22
+ </p>
23
+
24
+ <br/>
25
+
26
+ Explora el catálogo de modelos de [OrcaRouter](https://www.orcarouter.ai) y ejecuta
27
+ chat completions desde cualquier cliente del [Model Context Protocol](https://modelcontextprotocol.io)
28
+ — Claude Desktop, Claude Code, Cursor, Windsurf, Zed, o cualquier otro
29
+ que hable el protocolo.
30
+
31
+ La exploración del catálogo funciona **sin clave de API** — compara precios y
32
+ capacidades antes de registrarte.
33
+
34
+ ## Qué puedes hacer
35
+
36
+ - 🗺️ Descubre proveedores y modelos sin clave de API
37
+ - 💬 Ejecuta chat completions con cualquier modelo disponible
38
+ - 🧠 Enruta automáticamente las solicitudes a través del router `orcarouter/auto` de tu workspace (estrategias cost / quality / balanced / LinUCB / gated-adaptive)
39
+ - 🔁 Configura cadenas de fallback (primario + hasta 4 fallbacks) para mayor resiliencia
40
+ - 📊 Filtra modelos en el servidor por proveedor, capacidad o ventana de contexto mínima
41
+ - 🎯 Inspecciona fichas detalladas de modelos: precios, contexto, latencia, endpoints soportados
42
+ - 🔌 Funciona con Claude Desktop, Claude Code, Cursor, Windsurf, Zed y cualquier cliente MCP
43
+
44
+ ## Ejemplos
45
+
46
+ Prueba a decir cosas como:
47
+
48
+ - *"Lista todos los proveedores en OrcaRouter"*
49
+ - *"Muéstrame todos los modelos de Anthropic con sus precios"*
50
+ - *"Dame los detalles de `minimax/minimax-m2.7`"*
51
+ - *"Chatea con `orcarouter/auto` y explícame la computación cuántica"*
52
+
53
+ ## Inicio rápido
54
+
55
+ ### Claude Code (una línea en CLI)
56
+
57
+ ```bash
58
+ claude mcp add orcarouter -s user \
59
+ -e ORCAROUTER_API_KEY=sk-orca-your-key \
60
+ -- npx -y @orcarouter/mcp
61
+ ```
62
+
63
+ ### Otros clientes (ruta del archivo de configuración)
64
+
65
+ 1. Copia la configuración de ejemplo para tu cliente MCP en el archivo de configuración del cliente:
66
+
67
+ | Cliente | Ejemplo | Acción |
68
+ | --------------- | --------------------------------------------------- | ---------- |
69
+ | Claude Desktop | [claude-desktop.json](examples/claude-desktop.json) | Reemplazar |
70
+ | Claude Code | [claude-code.json](examples/claude-code.json) | Fusionar |
71
+ | Cursor | [cursor.json](examples/cursor.json) | Reemplazar |
72
+ | Windsurf | [windsurf.json](examples/windsurf.json) | Reemplazar |
73
+
74
+ Consulta [`examples/README.md`](examples/README.md) para las rutas de los archivos de configuración y notas sobre Zed y otros clientes.
75
+
76
+ 2. Reemplaza `sk-or-...` en el archivo copiado con tu [clave de API de OrcaRouter](https://www.orcarouter.ai/console).
77
+ 3. Reinicia tu cliente MCP.
78
+
79
+ Requiere Node.js 18 o superior. La variable de entorno `ORCAROUTER_API_KEY` solo
80
+ es necesaria para `orcarouter_chat`; las herramientas del catálogo funcionan sin ella.
81
+
82
+ ## Herramientas
83
+
84
+ - `orcarouter_chat` — ejecuta una chat completion (con cadena de fallback opcional)
85
+ - `orcarouter_models_list` — explora el catálogo (precios, contexto, capacidades)
86
+ - `orcarouter_model_card` — información detallada de un modelo
87
+ - `orcarouter_providers_list` — lista los proveedores con conteos de modelos
88
+
89
+ Los esquemas completos de entrada se exponen en tiempo de ejecución a través del método MCP `tools/list` — tu cliente MCP (Claude Desktop, Cursor, etc.) los lee automáticamente.
90
+
91
+ ## Configuración
92
+
93
+ | Nombre | Requerido | Descripción |
94
+ | ---------------------------- | --------- | -------------------------------------------------------- |
95
+ | `ORCAROUTER_API_KEY` | opcional | Clave de API de OrcaRouter. Solo necesaria para `orcarouter_chat`. |
96
+ | `ORCAROUTER_BASE_URL` | opcional | URL base de la API. Por defecto `https://api.orcarouter.ai`. |
97
+ | `ORCAROUTER_REQUEST_TIMEOUT` | opcional | Tiempo de espera HTTP por solicitud en **segundos**. Por defecto `300`. |
98
+
99
+ ## Seguridad
100
+
101
+ Las claves de API se leen desde variables de entorno, nunca se registran en logs y
102
+ solo se envían a la API de OrcaRouter. Consulta [SECURITY.md](SECURITY.md) para la
103
+ política de divulgación de vulnerabilidades.
104
+
105
+ ## Desarrollo
106
+
107
+ ```sh
108
+ # bun (preferido)
109
+ bun install
110
+ bun run test
111
+ bun run typecheck
112
+ bun run build
113
+
114
+ # o con npm
115
+ npm install
116
+ npm test
117
+ npm run typecheck
118
+ npm run build
119
+ ```
120
+
121
+ La compilación produce un bundle ESM en `dist/index.js` con un
122
+ shebang `#!/usr/bin/env node`, ejecutable como el binario `orcarouter-mcp`.
123
+
124
+ ## Licencia
125
+
126
+ [MIT](LICENSE)
package/README.fr.md ADDED
@@ -0,0 +1,126 @@
1
+ <p align="center">
2
+ <a href="https://www.orcarouter.ai">
3
+ <img src="https://raw.githubusercontent.com/Continuum-AI-Corp/orcarouter-mcp-server/main/assets/logo.gif" alt="OrcaRouter" width="180" />
4
+ </a>
5
+ </p>
6
+
7
+ <h1 align="center">OrcaRouter MCP Server</h1>
8
+
9
+ <p align="center">
10
+ Serveur MCP officiel pour la passerelle LLM <a href="https://www.orcarouter.ai">OrcaRouter</a>.
11
+ </p>
12
+
13
+ <p align="center">
14
+ <a href="https://discord.com/invite/943Zqp9bs"><img src="https://img.shields.io/discord/1501106943178309662?logo=discord&label=discord&color=5865F2" alt="Discord" /></a>
15
+ <a href="https://x.com/OrcaRouter"><img src="https://img.shields.io/badge/X-Follow-000000?logo=x&logoColor=white" alt="X" /></a>
16
+ <a href="https://www.npmjs.com/package/@orcarouter/mcp"><img src="https://img.shields.io/npm/v/@orcarouter/mcp" alt="npm version" /></a>
17
+ <a href="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml"><img src="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml/badge.svg" alt="CI" /></a>
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | <a href="README.it.md">Italiano</a> | <a href="README.ru.md">Русский</a> | <a href="README.pt.md">Português</a> | <a href="README.vi.md">Tiếng Việt</a> | <a href="README.hi.md">हिन्दी</a>
22
+ </p>
23
+
24
+ <br/>
25
+
26
+ Parcourez le catalogue de modèles d'[OrcaRouter](https://www.orcarouter.ai) et exécutez
27
+ des complétions de chat depuis n'importe quel client [Model Context Protocol](https://modelcontextprotocol.io)
28
+ — Claude Desktop, Claude Code, Cursor, Windsurf, Zed, ou tout autre client
29
+ qui parle le protocole.
30
+
31
+ La navigation du catalogue fonctionne **sans clé API** — comparez les tarifs et
32
+ les capacités avant de vous inscrire.
33
+
34
+ ## Ce que vous pouvez faire
35
+
36
+ - 🗺️ Découvrir les fournisseurs et les modèles sans clé API
37
+ - 💬 Exécuter des complétions de chat via n'importe quel modèle disponible
38
+ - 🧠 Router automatiquement les requêtes via le routeur `orcarouter/auto` de votre espace de travail (stratégies cost / quality / balanced / LinUCB / gated-adaptive)
39
+ - 🔁 Configurer des chaînes de repli (principal + jusqu'à 4 replis) pour la résilience
40
+ - 📊 Filtrer les modèles côté serveur par fournisseur, capacité ou fenêtre de contexte minimale
41
+ - 🎯 Inspecter des fiches détaillées : tarifs, contexte, latence, endpoints pris en charge
42
+ - 🔌 Compatible avec Claude Desktop, Claude Code, Cursor, Windsurf, Zed et tout client MCP
43
+
44
+ ## Exemples
45
+
46
+ Essayez de dire des choses comme :
47
+
48
+ - *"List all providers on OrcaRouter"*
49
+ - *"Show me all Anthropic models with their pricing"*
50
+ - *"Get details about `minimax/minimax-m2.7`"*
51
+ - *"Chat with `orcarouter/auto` and explain quantum computing"*
52
+
53
+ ## Démarrage rapide
54
+
55
+ ### Claude Code (commande CLI en une ligne)
56
+
57
+ ```bash
58
+ claude mcp add orcarouter -s user \
59
+ -e ORCAROUTER_API_KEY=sk-orca-your-key \
60
+ -- npx -y @orcarouter/mcp
61
+ ```
62
+
63
+ ### Autres clients (via fichier de configuration)
64
+
65
+ 1. Copiez l'exemple de configuration de votre client MCP dans le fichier de configuration du client :
66
+
67
+ | Client | Exemple | Action |
68
+ | --------------- | --------------------------------------------------- | ----------- |
69
+ | Claude Desktop | [claude-desktop.json](examples/claude-desktop.json) | Remplacer |
70
+ | Claude Code | [claude-code.json](examples/claude-code.json) | Fusionner |
71
+ | Cursor | [cursor.json](examples/cursor.json) | Remplacer |
72
+ | Windsurf | [windsurf.json](examples/windsurf.json) | Remplacer |
73
+
74
+ Consultez [`examples/README.md`](examples/README.md) pour les chemins des fichiers de configuration et les notes concernant Zed et les autres clients.
75
+
76
+ 2. Remplacez `sk-or-...` dans le fichier copié par votre [clé API OrcaRouter](https://www.orcarouter.ai/console).
77
+ 3. Redémarrez votre client MCP.
78
+
79
+ Node.js 18 ou ultérieur est requis. La variable d'environnement `ORCAROUTER_API_KEY`
80
+ n'est nécessaire que pour `orcarouter_chat` ; les outils de catalogue fonctionnent sans elle.
81
+
82
+ ## Outils
83
+
84
+ - `orcarouter_chat` — exécute une complétion de chat (avec chaîne de repli optionnelle)
85
+ - `orcarouter_models_list` — parcourt le catalogue (tarifs, contexte, capacités)
86
+ - `orcarouter_model_card` — informations détaillées sur un modèle
87
+ - `orcarouter_providers_list` — liste les fournisseurs avec le nombre de modèles
88
+
89
+ Les schémas d'entrée complets sont exposés à l'exécution via la méthode MCP `tools/list` — votre client MCP (Claude Desktop, Cursor, etc.) les lit automatiquement.
90
+
91
+ ## Configuration
92
+
93
+ | Nom | Requis | Description |
94
+ | --------------------------- | --------- | -------------------------------------------------------- |
95
+ | `ORCAROUTER_API_KEY` | optionnel | Clé API OrcaRouter. Requise uniquement pour `orcarouter_chat`. |
96
+ | `ORCAROUTER_BASE_URL` | optionnel | URL de base de l'API. Par défaut `https://api.orcarouter.ai`. |
97
+ | `ORCAROUTER_REQUEST_TIMEOUT`| optionnel | Délai d'expiration HTTP par requête en **secondes**. Par défaut `300`. |
98
+
99
+ ## Sécurité
100
+
101
+ Les clés API sont lues depuis les variables d'environnement, ne sont jamais journalisées et
102
+ ne sont envoyées qu'à l'API OrcaRouter. Consultez [SECURITY.md](SECURITY.md) pour la
103
+ politique de divulgation des vulnérabilités.
104
+
105
+ ## Développement
106
+
107
+ ```sh
108
+ # bun (préféré)
109
+ bun install
110
+ bun run test
111
+ bun run typecheck
112
+ bun run build
113
+
114
+ # ou avec npm
115
+ npm install
116
+ npm test
117
+ npm run typecheck
118
+ npm run build
119
+ ```
120
+
121
+ La compilation produit un bundle ESM dans `dist/index.js` avec un
122
+ shebang `#!/usr/bin/env node`, exécutable comme binaire `orcarouter-mcp`.
123
+
124
+ ## Licence
125
+
126
+ [MIT](LICENSE)
package/README.hi.md ADDED
@@ -0,0 +1,126 @@
1
+ <p align="center">
2
+ <a href="https://www.orcarouter.ai">
3
+ <img src="https://raw.githubusercontent.com/Continuum-AI-Corp/orcarouter-mcp-server/main/assets/logo.gif" alt="OrcaRouter" width="180" />
4
+ </a>
5
+ </p>
6
+
7
+ <h1 align="center">OrcaRouter MCP Server</h1>
8
+
9
+ <p align="center">
10
+ <a href="https://www.orcarouter.ai">OrcaRouter</a> LLM gateway के लिए आधिकारिक MCP server।
11
+ </p>
12
+
13
+ <p align="center">
14
+ <a href="https://discord.com/invite/943Zqp9bs"><img src="https://img.shields.io/discord/1501106943178309662?logo=discord&label=discord&color=5865F2" alt="Discord" /></a>
15
+ <a href="https://x.com/OrcaRouter"><img src="https://img.shields.io/badge/X-Follow-000000?logo=x&logoColor=white" alt="X" /></a>
16
+ <a href="https://www.npmjs.com/package/@orcarouter/mcp"><img src="https://img.shields.io/npm/v/@orcarouter/mcp" alt="npm version" /></a>
17
+ <a href="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml"><img src="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml/badge.svg" alt="CI" /></a>
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | <a href="README.it.md">Italiano</a> | <a href="README.ru.md">Русский</a> | <a href="README.pt.md">Português</a> | <a href="README.vi.md">Tiếng Việt</a> | <a href="README.hi.md">हिन्दी</a>
22
+ </p>
23
+
24
+ <br/>
25
+
26
+ [OrcaRouter](https://www.orcarouter.ai) की model catalog ब्राउज़ करें और किसी भी
27
+ [Model Context Protocol](https://modelcontextprotocol.io) client के अंदर से
28
+ chat completions चलाएँ — Claude Desktop, Claude Code, Cursor, Windsurf, Zed,
29
+ या protocol बोलने वाला कोई भी अन्य client।
30
+
31
+ Catalog ब्राउज़िंग **बिना API key के** काम करती है — साइन अप करने से पहले
32
+ pricing और क्षमताओं की तुलना करें।
33
+
34
+ ## आप क्या कर सकते हैं
35
+
36
+ - 🗺️ बिना API key के providers और models खोजें
37
+ - 💬 किसी भी सेवित model के माध्यम से chat completions चलाएँ
38
+ - 🧠 अपने workspace के `orcarouter/auto` router के ज़रिये अनुरोधों को auto-route करें (cost / quality / balanced / LinUCB / gated-adaptive रणनीतियाँ)
39
+ - 🔁 लचीलापन के लिए fallback chains कॉन्फ़िगर करें (primary + अधिकतम 4 fallbacks)
40
+ - 📊 provider, capability, या न्यूनतम context window के अनुसार server-side पर models फ़िल्टर करें
41
+ - 🎯 विस्तृत model cards देखें: pricing, context, latency, समर्थित endpoints
42
+ - 🔌 Claude Desktop, Claude Code, Cursor, Windsurf, Zed, और किसी भी MCP client के साथ काम करता है
43
+
44
+ ## उदाहरण
45
+
46
+ ऐसी बातें कहकर आज़माएँ:
47
+
48
+ - *"List all providers on OrcaRouter"*
49
+ - *"Show me all Anthropic models with their pricing"*
50
+ - *"Get details about `minimax/minimax-m2.7`"*
51
+ - *"Chat with `orcarouter/auto` and explain quantum computing"*
52
+
53
+ ## त्वरित शुरुआत
54
+
55
+ ### Claude Code (CLI one-liner)
56
+
57
+ ```bash
58
+ claude mcp add orcarouter -s user \
59
+ -e ORCAROUTER_API_KEY=sk-orca-your-key \
60
+ -- npx -y @orcarouter/mcp
61
+ ```
62
+
63
+ ### अन्य clients (config-file path)
64
+
65
+ 1. अपने MCP client के लिए उदाहरण config को client की config file में कॉपी करें:
66
+
67
+ | Client | Example | Action |
68
+ | --------------- | --------------------------------------------------- | ------- |
69
+ | Claude Desktop | [claude-desktop.json](examples/claude-desktop.json) | Replace |
70
+ | Claude Code | [claude-code.json](examples/claude-code.json) | Merge |
71
+ | Cursor | [cursor.json](examples/cursor.json) | Replace |
72
+ | Windsurf | [windsurf.json](examples/windsurf.json) | Replace |
73
+
74
+ config-file paths और Zed तथा अन्य clients पर नोट्स के लिए [`examples/README.md`](examples/README.md) देखें।
75
+
76
+ 2. कॉपी की गई file में `sk-or-...` को अपनी [OrcaRouter API key](https://www.orcarouter.ai/console) से बदलें।
77
+ 3. अपना MCP client पुनः प्रारंभ करें।
78
+
79
+ Node.js 18 या उसके बाद का संस्करण आवश्यक है। `ORCAROUTER_API_KEY` env var केवल
80
+ `orcarouter_chat` के लिए आवश्यक है; catalog tools इसके बिना काम करते हैं।
81
+
82
+ ## Tools
83
+
84
+ - `orcarouter_chat` — chat completion चलाएँ (वैकल्पिक fallback chain के साथ)
85
+ - `orcarouter_models_list` — catalog ब्राउज़ करें (pricing, context, capabilities)
86
+ - `orcarouter_model_card` — एक model के लिए विस्तृत जानकारी
87
+ - `orcarouter_providers_list` — model counts के साथ providers की सूची
88
+
89
+ पूरे input schemas runtime पर MCP `tools/list` विधि के माध्यम से उपलब्ध हैं — आपका MCP client (Claude Desktop, Cursor, इत्यादि) उन्हें स्वतः पढ़ लेता है।
90
+
91
+ ## कॉन्फ़िगरेशन
92
+
93
+ | Name | Required | Description |
94
+ | --------------------------- | -------- | -------------------------------------------------------- |
95
+ | `ORCAROUTER_API_KEY` | optional | OrcaRouter API key। केवल `orcarouter_chat` के लिए आवश्यक। |
96
+ | `ORCAROUTER_BASE_URL` | optional | API base URL। डिफ़ॉल्ट `https://api.orcarouter.ai`। |
97
+ | `ORCAROUTER_REQUEST_TIMEOUT`| optional | प्रति-अनुरोध HTTP timeout **सेकंड** में। डिफ़ॉल्ट `300`। |
98
+
99
+ ## सुरक्षा
100
+
101
+ API keys environment variables से पढ़ी जाती हैं, कभी log नहीं की जातीं, और केवल
102
+ OrcaRouter API को भेजी जाती हैं। vulnerability disclosure नीति के लिए
103
+ [SECURITY.md](SECURITY.md) देखें।
104
+
105
+ ## विकास
106
+
107
+ ```sh
108
+ # bun (preferred)
109
+ bun install
110
+ bun run test
111
+ bun run typecheck
112
+ bun run build
113
+
114
+ # or with npm
115
+ npm install
116
+ npm test
117
+ npm run typecheck
118
+ npm run build
119
+ ```
120
+
121
+ build `dist/index.js` पर एक ESM bundle उत्पन्न करता है जिसमें
122
+ `#!/usr/bin/env node` shebang होता है, जिसे `orcarouter-mcp` binary के रूप में चलाया जा सकता है।
123
+
124
+ ## लाइसेंस
125
+
126
+ [MIT](LICENSE)
package/README.it.md ADDED
@@ -0,0 +1,127 @@
1
+ <p align="center">
2
+ <a href="https://www.orcarouter.ai">
3
+ <img src="https://raw.githubusercontent.com/Continuum-AI-Corp/orcarouter-mcp-server/main/assets/logo.gif" alt="OrcaRouter" width="180" />
4
+ </a>
5
+ </p>
6
+
7
+ <h1 align="center">OrcaRouter MCP Server</h1>
8
+
9
+ <p align="center">
10
+ Server MCP ufficiale per il gateway LLM <a href="https://www.orcarouter.ai">OrcaRouter</a>.
11
+ </p>
12
+
13
+ <p align="center">
14
+ <a href="https://discord.com/invite/943Zqp9bs"><img src="https://img.shields.io/discord/1501106943178309662?logo=discord&label=discord&color=5865F2" alt="Discord" /></a>
15
+ <a href="https://x.com/OrcaRouter"><img src="https://img.shields.io/badge/X-Follow-000000?logo=x&logoColor=white" alt="X" /></a>
16
+ <a href="https://www.npmjs.com/package/@orcarouter/mcp"><img src="https://img.shields.io/npm/v/@orcarouter/mcp" alt="npm version" /></a>
17
+ <a href="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml"><img src="https://github.com/Continuum-AI-Corp/orcarouter-mcp-server/actions/workflows/test.yml/badge.svg" alt="CI" /></a>
18
+ </p>
19
+
20
+ <p align="center">
21
+ <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.fr.md">Français</a> | <a href="README.es.md">Español</a> | <a href="README.it.md">Italiano</a> | <a href="README.ru.md">Русский</a> | <a href="README.pt.md">Português</a> | <a href="README.vi.md">Tiếng Việt</a> | <a href="README.hi.md">हिन्दी</a>
22
+ </p>
23
+
24
+ <br/>
25
+
26
+ Esplora il catalogo dei modelli di [OrcaRouter](https://www.orcarouter.ai) ed
27
+ esegui chat completion da qualsiasi client [Model Context Protocol](https://modelcontextprotocol.io)
28
+ — Claude Desktop, Claude Code, Cursor, Windsurf, Zed o qualunque altro
29
+ strumento che parli il protocollo.
30
+
31
+ La consultazione del catalogo funziona **senza chiave API** — confronta
32
+ prezzi e capacità prima di registrarti.
33
+
34
+ ## Cosa puoi fare
35
+
36
+ - 🗺️ Scopri provider e modelli senza una chiave API
37
+ - 💬 Esegui chat completion attraverso qualsiasi modello servito
38
+ - 🧠 Instrada automaticamente le richieste tramite il router `orcarouter/auto` del tuo workspace (strategie cost / quality / balanced / LinUCB / gated-adaptive)
39
+ - 🔁 Configura catene di fallback (primario + fino a 4 fallback) per maggiore resilienza
40
+ - 📊 Filtra i modelli lato server per provider, capacità o context window minimo
41
+ - 🎯 Consulta schede modello dettagliate: prezzi, contesto, latenza, endpoint supportati
42
+ - 🔌 Funziona con Claude Desktop, Claude Code, Cursor, Windsurf, Zed e qualsiasi client MCP
43
+
44
+ ## Esempi
45
+
46
+ Prova a dire cose come:
47
+
48
+ - *"Elenca tutti i provider su OrcaRouter"*
49
+ - *"Mostrami tutti i modelli Anthropic con i relativi prezzi"*
50
+ - *"Dammi i dettagli su `minimax/minimax-m2.7`"*
51
+ - *"Chatta con `orcarouter/auto` e spiegami il quantum computing"*
52
+
53
+ ## Avvio rapido
54
+
55
+ ### Claude Code (one-liner da CLI)
56
+
57
+ ```bash
58
+ claude mcp add orcarouter -s user \
59
+ -e ORCAROUTER_API_KEY=sk-orca-your-key \
60
+ -- npx -y @orcarouter/mcp
61
+ ```
62
+
63
+ ### Altri client (percorso del file di configurazione)
64
+
65
+ 1. Copia la configurazione di esempio per il tuo client MCP nel file di configurazione del client:
66
+
67
+ | Client | Esempio | Azione |
68
+ | --------------- | --------------------------------------------------- | ---------- |
69
+ | Claude Desktop | [claude-desktop.json](examples/claude-desktop.json) | Sostituire |
70
+ | Claude Code | [claude-code.json](examples/claude-code.json) | Unire |
71
+ | Cursor | [cursor.json](examples/cursor.json) | Sostituire |
72
+ | Windsurf | [windsurf.json](examples/windsurf.json) | Sostituire |
73
+
74
+ Consulta [`examples/README.md`](examples/README.md) per i percorsi dei file di configurazione e le note su Zed e altri client.
75
+
76
+ 2. Sostituisci `sk-or-...` nel file copiato con la tua [chiave API OrcaRouter](https://www.orcarouter.ai/console).
77
+ 3. Riavvia il tuo client MCP.
78
+
79
+ Richiede Node.js 18 o successivo. La variabile d'ambiente `ORCAROUTER_API_KEY`
80
+ è necessaria solo per `orcarouter_chat`; gli strumenti di catalogo funzionano
81
+ senza di essa.
82
+
83
+ ## Strumenti
84
+
85
+ - `orcarouter_chat` — esegui una chat completion (con catena di fallback opzionale)
86
+ - `orcarouter_models_list` — esplora il catalogo (prezzi, contesto, capacità)
87
+ - `orcarouter_model_card` — informazioni dettagliate su un singolo modello
88
+ - `orcarouter_providers_list` — elenca i provider con il numero di modelli
89
+
90
+ Gli schemi di input completi sono esposti a runtime tramite il metodo MCP `tools/list` — il tuo client MCP (Claude Desktop, Cursor, ecc.) li legge automaticamente.
91
+
92
+ ## Configurazione
93
+
94
+ | Nome | Obbligatorio | Descrizione |
95
+ | --------------------------- | ------------ | -------------------------------------------------------- |
96
+ | `ORCAROUTER_API_KEY` | opzionale | Chiave API OrcaRouter. Necessaria solo per `orcarouter_chat`. |
97
+ | `ORCAROUTER_BASE_URL` | opzionale | URL base dell'API. Predefinito `https://api.orcarouter.ai`. |
98
+ | `ORCAROUTER_REQUEST_TIMEOUT`| opzionale | Timeout HTTP per richiesta in **secondi**. Predefinito `300`. |
99
+
100
+ ## Sicurezza
101
+
102
+ Le chiavi API vengono lette da variabili d'ambiente, mai registrate nei log
103
+ e inviate solo all'API di OrcaRouter. Consulta [SECURITY.md](SECURITY.md)
104
+ per la policy di divulgazione delle vulnerabilità.
105
+
106
+ ## Sviluppo
107
+
108
+ ```sh
109
+ # bun (preferito)
110
+ bun install
111
+ bun run test
112
+ bun run typecheck
113
+ bun run build
114
+
115
+ # oppure con npm
116
+ npm install
117
+ npm test
118
+ npm run typecheck
119
+ npm run build
120
+ ```
121
+
122
+ La build produce un bundle ESM in `dist/index.js` con shebang
123
+ `#!/usr/bin/env node`, eseguibile come binario `orcarouter-mcp`.
124
+
125
+ ## Licenza
126
+
127
+ [MIT](LICENSE)