[{"_1":2,"_439":-5,"_440":-5},"loaderData",{"_3":4,"_22":23,"_284":285},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",17495170,"membership","referenceId","0199ab24-15cd-719b-b50b-df06c33c002b","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_79":-5,"_80":38,"_27":81,"_199":200,"_282":283},"availableLocales",[26,38,44,51,58,65,72],{"_27":28,"_31":35,"_36":37},"mcpServer",{"_29":30,"_31":32,"_33":34},"description","MCP-Server, der über MCP-Ressourcen tokeneffizienten Zugriff auf OpenAPI/Swagger-Spezifikationen für die clientseitige Erkundung bietet.","name","OpenAPI Schema Explorer","readme","# MCP OpenAPI Schema Explorer\n\n[![npm-Version](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![NPM-Downloads](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![Docker-Pulls](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer) [![Lizenz: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Codecov](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer) [![Verifiziert auf MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)\n\nEin MCP-Server (Model Context Protocol), der über **MCP-Ressourcen** tokeneffizienten Zugriff auf OpenAPI- (v3.0) und Swagger- (v2.0) Spezifikationen bietet.\n\n## Projektziel\n\nDas Hauptziel dieses Projekts besteht darin, MCP-Clients (wie Cline oder Claude Desktop) die Möglichkeit zu geben, die Struktur und Details großer OpenAPI-Spezifikationen zu erkunden, ohne die gesamte Datei in das Kontextfenster eines LLM laden zu müssen. Dies wird erreicht, indem Teile der Spezifikation über MCP-Ressourcen bereitgestellt werden, die sich gut für die schreibgeschützte Datenexploration eignen.\n\nDieser Server unterstützt das Laden von Spezifikationen sowohl aus lokalen Dateipfaden als auch aus Remote-HTTP/HTTPS-URLs. Swagger v2.0-Spezifikationen werden beim Laden automatisch in OpenAPI v3.0 konvertiert.\n\n## Warum MCP Resources?\n\nDas Model Context Protocol definiert sowohl **Ressourcen** als auch **Tools** .\n\n* **Ressourcen:** Stellen Datenquellen dar (wie Dateien, API-Antworten). Sie eignen sich ideal für den schreibgeschützten Zugriff und die Erkundung durch MCP-Clients (z. B. zum Durchsuchen von API-Pfaden in Claude Desktop).\n* **Tools:** Stellen ausführbare Aktionen oder Funktionen dar, die häufig von LLMs verwendet werden, um Aufgaben auszuführen oder mit externen Systemen zu interagieren.\n\nWährend andere MCP-Server Zugriff auf OpenAPI-Spezifikationen über *Tools* ermöglichen, konzentriert sich dieses Projekt speziell auf den Zugriff über *Resources* . Dies macht es besonders nützlich für die direkte Erkundung innerhalb von MCP-Clientanwendungen.\n\nWeitere Einzelheiten zu MCP-Clients und ihren Funktionen finden Sie in der [MCP-Client-Dokumentation](https://modelcontextprotocol.io/clients) .\n\n## Installation\n\nFür die empfohlenen Verwendungsmethoden ( `npx` und Docker, unten beschrieben) **ist kein separater Installationsschritt erforderlich** . Ihr MCP-Client lädt das Paket herunter oder ruft das Docker-Image basierend auf der von Ihnen angegebenen Konfiguration automatisch ab.\n\nWenn Sie den Server jedoch lieber explizit installieren möchten oder müssen, haben Sie zwei Möglichkeiten:\n\n1. **Globale Installation:** Sie können das Paket global mit npm installieren:\n\n ```bash\n npm install -g mcp-openapi-schema-explorer\n ```\n\n Informationen zum Konfigurieren Ihres MCP-Clients für die Verwendung eines global installierten Servers finden Sie weiter unten unter **Methode 3** .\n\n2. **Lokale Entwicklung/Installation:** Sie können das Repository klonen und lokal erstellen:\n\n ```bash\n git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git\n cd mcp-openapi-schema-explorer\n npm install\n npm run build\n ```\n\n Unter **Methode 4** unten erfahren Sie, wie Sie Ihren MCP-Client so konfigurieren, dass der Server mithilfe von `node` von Ihrem lokalen Build aus ausgeführt wird.\n\n## Hinzufügen des Servers zu Ihrem MCP-Client\n\nDieser Server ist für den Betrieb durch MCP-Clients (wie Claude Desktop, Windsurf, Cline usw.) konzipiert. Um ihn zu nutzen, fügen Sie der Einstellungsdatei Ihres Clients (häufig eine JSON-Datei) einen Konfigurationseintrag hinzu. Dieser Eintrag teilt dem Client mit, wie der Serverprozess ausgeführt werden soll (z. B. mit `npx` , `docker` oder `node` ). Der Server selbst benötigt keine separate Konfiguration über die im Client-Einstellungseintrag angegebenen Kommandozeilenargumente hinaus.\n\nNachfolgend finden Sie die gängigen Methoden zum Hinzufügen des Servereintrags zur Konfiguration Ihres Clients.\n\n### Methode 1: npx (empfohlen)\n\nDie Verwendung `npx` wird empfohlen, da dadurch eine globale/lokale Installation vermieden wird und sichergestellt wird, dass der Client die neueste veröffentlichte Version verwendet.\n\n**Beispiel eines Client-Konfigurationseintrags (npx-Methode):**\n\nFügen Sie das folgende JSON-Objekt zum Abschnitt `mcpServers` der Konfigurationsdatei Ihres MCP-Clients hinzu. Dieser Eintrag weist den Client an, wie er den Server mit `npx` ausführen soll:\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (npx)\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-openapi-schema-explorer@latest\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n}\n```\n\n**Konfigurationshinweise:**\n\n* Ersetzen Sie `\"My API Spec (npx)\"` durch einen eindeutigen Namen für diese Serverinstanz in Ihrem Client.\n* Ersetzen Sie `` durch den absoluten lokalen Dateipfad oder die vollständige Remote-URL Ihrer Spezifikation.\n* Das `--output-format` ist optional ( `json` , `yaml` , `json-minified` ), der Standardwert ist `json` .\n* Um mehrere Spezifikationen zu untersuchen, fügen Sie in `mcpServers` separate Einträge hinzu, von denen jeder einen eindeutigen Namen hat und auf eine andere Spezifikation verweist.\n\n### Methode 2: Docker\n\nSie können Ihren MCP-Client anweisen, den Server mit dem offiziellen Docker-Image auszuführen: `kadykov/mcp-openapi-schema-explorer` .\n\n**Beispiele für Client-Konfigurationseinträge (Docker-Methode):**\n\nFügen Sie im Abschnitt `mcpServers` der Konfigurationsdatei Ihres MCP-Clients eines der folgenden JSON-Objekte hinzu. Diese Einträge weisen den Client an, wie der Server mit `docker run` ausgeführt wird:\n\n* **Remote-URL:** Übergeben Sie die URL direkt an `docker run` .\n\n* **Verwenden einer Remote-URL:**\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Remote)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n* **Verwenden einer lokalen Datei:** (Erfordert das Einbinden der Datei in den Container)\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Local)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-v\",\n \"/full/host/path/to/spec.yaml:/spec/api.yaml\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"/spec/api.yaml\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n **Wichtig:** Ersetzen Sie `/full/host/path/to/spec.yaml` durch den korrekten absoluten Pfad auf Ihrem Host-Rechner. Der Pfad `/spec/api.yaml` ist der entsprechende Pfad innerhalb des Containers.\n\n### Methode 3: Globale Installation (weniger verbreitet)\n\nWenn Sie das Paket global mit `npm install -g` installiert haben, können Sie Ihren Client so konfigurieren, dass es direkt ausgeführt wird.\n\n```bash\n# Run this command once in your terminal\nnpm install -g mcp-openapi-schema-explorer\n```\n\n**Beispiel eines Client-Konfigurationseintrags (globale Installationsmethode):**\n\nFügen Sie den folgenden Eintrag zur Konfigurationsdatei Ihres MCP-Clients hinzu. Dies setzt voraus, dass der Befehl `mcp-openapi-schema-explorer` im PATH der Ausführungsumgebung des Clients zugänglich ist.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Global)\": {\n \"command\": \"mcp-openapi-schema-explorer\",\n \"args\": [\"\", \"--output-format\", \"yaml\"],\n \"env\": {}\n }\n }\n}\n```\n\n* Stellen Sie sicher, dass der `command` ( `mcp-openapi-schema-explorer` ) in der von Ihrem MCP-Client verwendeten Umgebungsvariable PATH zugänglich ist.\n\n### Methode 4: Lokale Entwicklung/Installation\n\nDiese Methode ist nützlich, wenn Sie das Repository lokal zur Entwicklung geklont haben oder eine geänderte Version ausführen möchten.\n\n**Einrichtungsschritte (einmal in Ihrem Terminal ausführen):**\n\n1. Klonen Sie das Repository: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`\n2. Navigieren Sie in das Verzeichnis: `cd mcp-openapi-schema-explorer`\n3. Abhängigkeiten installieren: `npm install`\n4. Erstellen Sie das Projekt: `npm run build` (oder `just build` )\n\n**Beispiel für einen Client-Konfigurationseintrag (lokale Entwicklungsmethode):**\n\nFügen Sie der Konfigurationsdatei Ihres MCP-Clients den folgenden Eintrag hinzu. Dadurch wird der Client angewiesen, den lokal erstellten Server mit `node` auszuführen.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Local Dev)\": {\n \"command\": \"node\",\n \"args\": [\n \"/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n\n \"env\": {}\n }\n }\n}\n```\n\n**Wichtig:** Ersetzen Sie `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js` durch den richtigen absoluten Pfad zur erstellten Datei `index.js` in Ihrem geklonten Repository.\n\n## Merkmale\n\n* **MCP-Ressourcenzugriff:** Erkunden Sie OpenAPI-Spezifikationen über intuitive URIs ( `openapi://info` , `openapi://paths/...` , `openapi://components/...` ).\n* **Unterstützung für OpenAPI v3.0 und Swagger v2.0:** Lädt beide Formate und konvertiert v2.0 automatisch in v3.0.\n* **Lokale und Remote-Dateien:** Laden Sie Spezifikationen von lokalen Dateipfaden oder HTTP/HTTPS-URLs.\n* **Token-effizient:** Entwickelt, um die Token-Nutzung für LLMs durch Bereitstellung eines strukturierten Zugriffs zu minimieren.\n* **Mehrere Ausgabeformate:** Erhalten Sie detaillierte Ansichten in JSON (Standard), YAML oder minimiertem JSON ( `--output-format` ).\n* **Dynamischer Servername:** Der Servername in MCP-Clients spiegelt den `info.title` aus der geladenen Spezifikation wider.\n* **Referenztransformation:** Interne `$ref` s ( `#/components/...` ) werden in anklickbare MCP-URIs umgewandelt.\n\n## Verfügbare MCP-Ressourcen\n\nDieser Server stellt die folgenden MCP-Ressourcenvorlagen zum Erkunden der OpenAPI-Spezifikation bereit.\n\n**Grundlegendes zu mehrwertigen Parametern ( `*` )**\n\nEinige Ressourcenvorlagen enthalten Parameter, die mit einem Sternchen ( `*` ) enden, wie z. B. `{method*}` oder `{name*}` . Dies bedeutet, dass der Parameter **mehrere durch Kommas getrennte Werte** akzeptiert. Um beispielsweise Details sowohl für die `GET` als auch für die `POST` Methode eines Pfads anzufordern, verwenden Sie eine URI wie `openapi://paths/users/get,post` . Dadurch können Details für mehrere Elemente in einer einzigen Anfrage abgerufen werden.\n\n**Ressourcenvorlagen:**\n\n* **`openapi://{field}`**\n\n * **Beschreibung:** Greift auf die Felder der obersten Ebene des OpenAPI-Dokuments zu (z. B. `info` , `servers` , `tags` ) oder listet den Inhalt von `paths` oder `components` auf. Die jeweils verfügbaren Felder hängen von der geladenen Spezifikation ab.\n * **Beispiel:** `openapi://info`\n * **Ausgabe:** `text/plain` Liste für `paths` und `components` ; konfiguriertes Format (JSON/YAML/minimiertes JSON) für andere Felder.\n * **Vervollständigungen:** Bietet dynamische Vorschläge für `{field}` basierend auf den tatsächlichen Schlüsseln der obersten Ebene, die in der geladenen Spezifikation gefunden wurden.\n\n* **`openapi://paths/{path}`**\n\n * **Beschreibung:** Listet die verfügbaren HTTP-Methoden (Operationen) für einen bestimmten API-Pfad auf.\n * **Parameter:** `{path}` – Die API-Pfadzeichenfolge. **Muss URL-codiert sein** (z. B. wird aus `/users/{id}``users%2F%7Bid%7D` ).\n * **Beispiel:** `openapi://paths/users%2F%7Bid%7D`\n * **Ausgabe:** `text/plain` Liste der Methoden.\n * **Vervollständigungen:** Bietet dynamische Vorschläge für `{path}` basierend auf den in der geladenen Spezifikation gefundenen Pfaden (URL-codiert).\n\n* **`openapi://paths/{path}/{method*}`**\n\n * **Beschreibung:** Ruft die detaillierte Spezifikation für eine oder mehrere Operationen (HTTP-Methoden) auf einem bestimmten API-Pfad ab.\n * **Parameter:**\n\n * `{path}` – Die API-Pfadzeichenfolge. **Muss URL-codiert sein** .\n * `{method*}` – Eine oder mehrere HTTP-Methoden (z. B. `get` , `post` , `get,post` ). Groß-/Kleinschreibung wird nicht berücksichtigt.\n * **Beispiel (Einzeln):** `openapi://paths/users%2F%7Bid%7D/get`\n * **Beispiel (mehrere):** `openapi://paths/users%2F%7Bid%7D/get,post`\n * **Ausgabe:** Konfiguriertes Format (JSON/YAML/minimiertes JSON).\n * **Vervollständigungen:** Bietet dynamische Vorschläge für `{path}` . Bietet statische Vorschläge für `{method*}` (gängige HTTP-Verben wie GET, POST, PUT, DELETE usw.).\n\n* **`openapi://components/{type}`**\n\n * **Beschreibung:** Listet die Namen aller definierten Komponenten eines bestimmten Typs auf (z. B. `schemas` , `responses` , `parameters` ). Die jeweils verfügbaren Typen hängen von der geladenen Spezifikation ab. Bietet außerdem eine kurze Beschreibung für jeden aufgelisteten Typ.\n * **Beispiel:** `openapi://components/schemas`\n * **Ausgabe:** `text/plain` Liste der Komponentennamen mit Beschreibungen.\n * **Vervollständigungen:** Bietet dynamische Vorschläge für `{type}` basierend auf den in der geladenen Spezifikation gefundenen Komponententypen.\n\n* **`openapi://components/{type}/{name*}`**\n\n * **Beschreibung:** Ruft die detaillierte Spezifikation für eine oder mehrere benannte Komponenten eines bestimmten Typs ab.\n * **Parameter:**\n\n * `{type}` – Der Komponententyp.\n * `{name*}` – Ein oder mehrere Komponentennamen (z. B. `User` , `Order` , `User,Order` ). Groß-/Kleinschreibung wird beachtet.\n * **Beispiel (Einzeln):** `openapi://components/schemas/User`\n * **Beispiel (mehrere):** `openapi://components/schemas/User,Order`\n * **Ausgabe:** Konfiguriertes Format (JSON/YAML/minimiertes JSON).\n * **Vervollständigungen:** Bietet dynamische Vorschläge für `{type}` . Dynamische Vorschläge für `{name*}` werden *nur dann bereitgestellt, wenn* die geladene Spezifikation insgesamt genau einen Komponententyp enthält (z. B. nur `schemas` ). Diese Einschränkung besteht, weil das MCP SDK derzeit keine Vervollständigungen für den ausgewählten `{type}` unterstützt. Die Angabe aller Namen für alle Typen könnte irreführend sein.\n\n## Beitragen\n\nBeiträge sind willkommen! Hinweise zum Einrichten der Entwicklungsumgebung, Ausführen von Tests und Einreichen von Änderungen finden Sie in der Datei [CONTRIBUTING.md](CONTRIBUTING.md) .\n\n## Veröffentlichungen\n\nDieses Projekt verwendet [`semantic-release`](https://github.com/semantic-release/semantic-release) für die automatisierte Versionsverwaltung und Paketveröffentlichung basierend auf [konventionellen Commits](https://www.conventionalcommits.org/) .\n\n## Zukunftspläne\n\n(Zukünftige Pläne müssen noch festgelegt werden)","German","tag","de-DE",{"_27":39,"_31":42,"_36":43},{"_29":40,"_31":32,"_33":41},"MCP server providing token-efficient access to OpenAPI/Swagger specs via MCP Resources for client-side exploration.","

\n $\"MCP$ \n

\n\n# MCP OpenAPI Schema Explorer\n\n[![npm version](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer)\n[![NPM Downloads](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer)\n[![Docker Pulls](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![codecov](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer)\n[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)\n\nAn MCP (Model Context Protocol) server that provides token-efficient access to OpenAPI (v3.0) and Swagger (v2.0) specifications via **MCP Resources**.\n\n## Project Goal\n\nThe primary goal of this project is to allow MCP clients (like Cline or Claude Desktop) to explore the structure and details of large OpenAPI specifications without needing to load the entire file into an LLM's context window. It achieves this by exposing parts of the specification through MCP Resources, which are well-suited for read-only data exploration.\n\nThis server supports loading specifications from both local file paths and remote HTTP/HTTPS URLs. Swagger v2.0 specifications are automatically converted to OpenAPI v3.0 upon loading.\n\n## Why MCP Resources?\n\nThe Model Context Protocol defines both **Resources** and **Tools**.\n\n- **Resources:** Represent data sources (like files, API responses). They are ideal for read-only access and exploration by MCP clients (e.g., browsing API paths in Claude Desktop).\n- **Tools:** Represent executable actions or functions, often used by LLMs to perform tasks or interact with external systems.\n\nWhile other MCP servers exist that provide access to OpenAPI specs via _Tools_, this project specifically focuses on providing access via _Resources_. This makes it particularly useful for direct exploration within MCP client applications.\n\nFor more details on MCP clients and their capabilities, see the [MCP Client Documentation](https://modelcontextprotocol.io/clients).\n\n## Installation\n\nFor the recommended usage methods (`npx` and Docker, described below), **no separate installation step is required**. Your MCP client will download the package or pull the Docker image automatically based on the configuration you provide.\n\nHowever, if you prefer or need to install the server explicitly, you have two options:\n\n1. **Global Installation:** You can install the package globally using npm:\n\n ```bash\n npm install -g mcp-openapi-schema-explorer\n ```\n\n See **Method 3** below for how to configure your MCP client to use a globally installed server.\n\n2. **Local Development/Installation:** You can clone the repository and build it locally:\n ```bash\n git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git\n cd mcp-openapi-schema-explorer\n npm install\n npm run build\n ```\n See **Method 4** below for how to configure your MCP client to run the server from your local build using `node`.\n\n## Adding the Server to your MCP Client\n\nThis server is designed to be run by MCP clients (like Claude Desktop, Windsurf, Cline, etc.). To use it, you add a configuration entry to your client's settings file (often a JSON file). This entry tells the client how to execute the server process (e.g., using `npx`, `docker`, or `node`). The server itself doesn't require separate configuration beyond the command-line arguments specified in the client settings entry.\n\nBelow are the common methods for adding the server entry to your client's configuration.\n\n### Method 1: npx (Recommended)\n\nUsing `npx` is recommended as it avoids global/local installation and ensures the client uses the latest published version.\n\n**Example Client Configuration Entry (npx Method):**\n\nAdd the following JSON object to the `mcpServers` section of your MCP client's configuration file. This entry instructs the client on how to run the server using `npx`:\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (npx)\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-openapi-schema-explorer@latest\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n}\n```\n\n**Configuration Notes:**\n\n- Replace `\"My API Spec (npx)\"` with a unique name for this server instance in your client.\n- Replace `` with the absolute local file path or full remote URL of your specification.\n- The `--output-format` is optional (`json`, `yaml`, `json-minified`), defaulting to `json`.\n- To explore multiple specifications, add separate entries in `mcpServers`, each with a unique name and pointing to a different spec.\n\n### Method 2: Docker\n\nYou can instruct your MCP client to run the server using the official Docker image: `kadykov/mcp-openapi-schema-explorer`.\n\n**Example Client Configuration Entries (Docker Method):**\n\nAdd one of the following JSON objects to the `mcpServers` section of your MCP client's configuration file. These entries instruct the client on how to run the server using `docker run`:\n\n- **Remote URL:** Pass the URL directly to `docker run`.\n\n- **Using a Remote URL:**\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Remote)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n- **Using a Local File:** (Requires mounting the file into the container)\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Local)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-v\",\n \"/full/host/path/to/spec.yaml:/spec/api.yaml\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"/spec/api.yaml\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n **Important:** Replace `/full/host/path/to/spec.yaml` with the correct absolute path on your host machine. The path `/spec/api.yaml` is the corresponding path inside the container.\n\n### Method 3: Global Installation (Less Common)\n\nIf you have installed the package globally using `npm install -g`, you can configure your client to run it directly.\n\n```bash\n# Run this command once in your terminal\nnpm install -g mcp-openapi-schema-explorer\n```\n\n**Example Client Configuration Entry (Global Install Method):**\n\nAdd the following entry to your MCP client's configuration file. This assumes the `mcp-openapi-schema-explorer` command is accessible in the client's execution environment PATH.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Global)\": {\n \"command\": \"mcp-openapi-schema-explorer\",\n \"args\": [\"\", \"--output-format\", \"yaml\"],\n \"env\": {}\n }\n }\n}\n```\n\n- Ensure the `command` (`mcp-openapi-schema-explorer`) is accessible in the PATH environment variable used by your MCP client.\n\n### Method 4: Local Development/Installation\n\nThis method is useful if you have cloned the repository locally for development or to run a modified version.\n\n**Setup Steps (Run once in your terminal):**\n\n1. Clone the repository: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`\n2. Navigate into the directory: `cd mcp-openapi-schema-explorer`\n3. Install dependencies: `npm install`\n4. Build the project: `npm run build` (or `just build`)\n\n**Example Client Configuration Entry (Local Development Method):**\n\nAdd the following entry to your MCP client's configuration file. This instructs the client to run the locally built server using `node`.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Local Dev)\": {\n \"command\": \"node\",\n \"args\": [\n \"/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n\n \"env\": {}\n }\n }\n}\n```\n\n**Important:** Replace `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js` with the correct absolute path to the built `index.js` file in your cloned repository.\n\n## Features\n\n- **MCP Resource Access:** Explore OpenAPI specs via intuitive URIs (`openapi://info`, `openapi://paths/...`, `openapi://components/...`).\n- **OpenAPI v3.0 & Swagger v2.0 Support:** Loads both formats, automatically converting v2.0 to v3.0.\n- **Local & Remote Files:** Load specs from local file paths or HTTP/HTTPS URLs.\n- **Token-Efficient:** Designed to minimize token usage for LLMs by providing structured access.\n- **Multiple Output Formats:** Get detailed views in JSON (default), YAML, or minified JSON (`--output-format`).\n- **Dynamic Server Name:** Server name in MCP clients reflects the `info.title` from the loaded spec.\n- **Reference Transformation:** Internal `$ref`s (`#/components/...`) are transformed into clickable MCP URIs.\n\n## Available MCP Resources\n\nThis server exposes the following MCP resource templates for exploring the OpenAPI specification.\n\n**Understanding Multi-Value Parameters (`*`)**\n\nSome resource templates include parameters ending with an asterisk (`*`), like `{method*}` or `{name*}`. This indicates that the parameter accepts **multiple comma-separated values**. For example, to request details for both the `GET` and `POST` methods of a path, you would use a URI like `openapi://paths/users/get,post`. This allows fetching details for multiple items in a single request.\n\n**Resource Templates:**\n\n- **`openapi://{field}`**\n\n - **Description:** Accesses top-level fields of the OpenAPI document (e.g., `info`, `servers`, `tags`) or lists the contents of `paths` or `components`. The specific available fields depend on the loaded specification.\n - **Example:** `openapi://info`\n - **Output:** `text/plain` list for `paths` and `components`; configured format (JSON/YAML/minified JSON) for other fields.\n - **Completions:** Provides dynamic suggestions for `{field}` based on the actual top-level keys found in the loaded spec.\n\n- **`openapi://paths/{path}`**\n\n - **Description:** Lists the available HTTP methods (operations) for a specific API path.\n - **Parameter:** `{path}` - The API path string. **Must be URL-encoded** (e.g., `/users/{id}` becomes `users%2F%7Bid%7D`).\n - **Example:** `openapi://paths/users%2F%7Bid%7D`\n - **Output:** `text/plain` list of methods.\n - **Completions:** Provides dynamic suggestions for `{path}` based on the paths found in the loaded spec (URL-encoded).\n\n- **`openapi://paths/{path}/{method*}`**\n\n - **Description:** Gets the detailed specification for one or more operations (HTTP methods) on a specific API path.\n - **Parameters:**\n - `{path}` - The API path string. **Must be URL-encoded**.\n - `{method*}` - One or more HTTP methods (e.g., `get`, `post`, `get,post`). Case-insensitive.\n - **Example (Single):** `openapi://paths/users%2F%7Bid%7D/get`\n - **Example (Multiple):** `openapi://paths/users%2F%7Bid%7D/get,post`\n - **Output:** Configured format (JSON/YAML/minified JSON).\n - **Completions:** Provides dynamic suggestions for `{path}`. Provides static suggestions for `{method*}` (common HTTP verbs like GET, POST, PUT, DELETE, etc.).\n\n- **`openapi://components/{type}`**\n\n - **Description:** Lists the names of all defined components of a specific type (e.g., `schemas`, `responses`, `parameters`). The specific available types depend on the loaded specification. Also provides a short description for each listed type.\n - **Example:** `openapi://components/schemas`\n - **Output:** `text/plain` list of component names with descriptions.\n - **Completions:** Provides dynamic suggestions for `{type}` based on the component types found in the loaded spec.\n\n- **`openapi://components/{type}/{name*}`**\n - **Description:** Gets the detailed specification for one or more named components of a specific type.\n - **Parameters:**\n - `{type}` - The component type.\n - `{name*}` - One or more component names (e.g., `User`, `Order`, `User,Order`). Case-sensitive.\n - **Example (Single):** `openapi://components/schemas/User`\n - **Example (Multiple):** `openapi://components/schemas/User,Order`\n - **Output:** Configured format (JSON/YAML/minified JSON).\n - **Completions:** Provides dynamic suggestions for `{type}`. Provides dynamic suggestions for `{name*}` _only if_ the loaded spec contains exactly one component type overall (e.g., only `schemas`). This limitation exists because the MCP SDK currently doesn't support providing completions scoped to the selected `{type}`; providing all names across all types could be misleading.\n\n## Contributing\n\nContributions are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines on setting up the development environment, running tests, and submitting changes.\n\n## Releases\n\nThis project uses [`semantic-release`](https://github.com/semantic-release/semantic-release) for automated version management and package publishing based on [Conventional Commits](https://www.conventionalcommits.org/).\n\n## Future Plans\n\n(Future plans to be determined)\n","English","en-US",{"_27":45,"_31":49,"_36":50},{"_29":46,"_31":47,"_33":48},"Servidor MCP que proporciona acceso eficiente en términos de tokens a las especificaciones OpenAPI/Swagger a través de recursos MCP para la exploración del lado del cliente.","Explorador de esquemas OpenAPI","# Explorador de esquemas OpenAPI de MCP\n\n[![versión npm](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![Descargas de NPM](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![Docker Pulls](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer) [![Licencia: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![código decodificador](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer) [![Verificado en MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)\n\nUn servidor MCP (Protocolo de contexto de modelo) que proporciona acceso eficiente en términos de tokens a las especificaciones OpenAPI (v3.0) y Swagger (v2.0) a través de **recursos MCP** .\n\n## Objetivo del proyecto\n\nEl objetivo principal de este proyecto es permitir que los clientes MCP (como Cline o Claude Desktop) exploren la estructura y los detalles de especificaciones OpenAPI extensas sin necesidad de cargar el archivo completo en la ventana de contexto de un LLM. Esto se logra exponiendo partes de la especificación a través de Recursos MCP, ideales para la exploración de datos de solo lectura.\n\nEste servidor admite la carga de especificaciones tanto desde rutas de archivos locales como desde URL HTTP/HTTPS remotas. Las especificaciones de Swagger v2.0 se convierten automáticamente a OpenAPI v3.0 al cargar.\n\n## ¿Por qué MCP Resources?\n\nEl Protocolo de Contexto Modelo define tanto **Recursos** como **Herramientas** .\n\n* **Recursos:** Representan fuentes de datos (como archivos y respuestas de API). Son ideales para el acceso de solo lectura y la exploración por parte de clientes de MCP (p. ej., al explorar rutas de API en Claude Desktop).\n* **Herramientas:** representan acciones o funciones ejecutables, a menudo utilizadas por los LLM para realizar tareas o interactuar con sistemas externos.\n\nAunque existen otros servidores MCP que proporcionan acceso a las especificaciones de OpenAPI mediante *Herramientas* , este proyecto se centra específicamente en proporcionar acceso mediante *Recursos* . Esto lo hace especialmente útil para la exploración directa dentro de las aplicaciones cliente MCP.\n\nPara obtener más detalles sobre los clientes MCP y sus capacidades, consulte la [Documentación del cliente MCP](https://modelcontextprotocol.io/clients) .\n\n## Instalación\n\nPara los métodos de uso recomendados ( `npx` y Docker, descritos a continuación), **no se requiere ninguna instalación adicional** . Su cliente MCP descargará el paquete o extraerá la imagen de Docker automáticamente según la configuración que proporcione.\n\nSin embargo, si prefieres o necesitas instalar el servidor explícitamente, tienes dos opciones:\n\n1. **Instalación global:** puedes instalar el paquete globalmente usando npm:\n\n ```bash\n npm install -g mcp-openapi-schema-explorer\n ```\n\n Consulte **el método 3** a continuación para saber cómo configurar su cliente MCP para utilizar un servidor instalado globalmente.\n\n2. **Desarrollo/Instalación local:** puedes clonar el repositorio y compilarlo localmente:\n\n ```bash\n git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git\n cd mcp-openapi-schema-explorer\n npm install\n npm run build\n ```\n\n Consulte **el Método 4** a continuación para saber cómo configurar su cliente MCP para ejecutar el servidor desde su compilación local usando `node` .\n\n## Cómo agregar el servidor a su cliente MCP\n\nEste servidor está diseñado para ser ejecutado por clientes MCP (como Claude Desktop, Windsurf, Cline, etc.). Para usarlo, se agrega una entrada de configuración al archivo de configuración del cliente (generalmente un archivo JSON). Esta entrada indica al cliente cómo ejecutar el proceso del servidor (por ejemplo, usando `npx` , `docker` o `node` ). El servidor en sí no requiere configuración adicional más allá de los argumentos de la línea de comandos especificados en la entrada de configuración del cliente.\n\nA continuación se muestran los métodos comunes para agregar la entrada del servidor a la configuración de su cliente.\n\n### Método 1: npx (recomendado)\n\nSe recomienda usar `npx` ya que evita la instalación global/local y garantiza que el cliente utilice la última versión publicada.\n\n**Ejemplo de entrada de configuración de cliente (método npx):**\n\nAgregue el siguiente objeto JSON a la sección `mcpServers` del archivo de configuración de su cliente MCP. Esta entrada indica al cliente cómo ejecutar el servidor usando `npx` :\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (npx)\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-openapi-schema-explorer@latest\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n}\n```\n\n**Notas de configuración:**\n\n* Reemplace `\"My API Spec (npx)\"` con un nombre único para esta instancia de servidor en su cliente.\n* Reemplace `` con la ruta de archivo local absoluta o la URL remota completa de su especificación.\n* El `--output-format` es opcional ( `json` , `yaml` , `json-minified` ) y el valor predeterminado es `json` .\n* Para explorar múltiples especificaciones, agregue entradas separadas en `mcpServers` , cada una con un nombre único y que apunte a una especificación diferente.\n\n### Método 2: Docker\n\nPuede indicarle a su cliente MCP que ejecute el servidor usando la imagen oficial de Docker: `kadykov/mcp-openapi-schema-explorer` .\n\n**Ejemplo de entradas de configuración de cliente (método Docker):**\n\nAgregue uno de los siguientes objetos JSON a la sección `mcpServers` del archivo de configuración de su cliente MCP. Estas entradas indican al cliente cómo ejecutar el servidor mediante `docker run` :\n\n* **URL remota:** pasa la URL directamente a `docker run` .\n\n* **Usando una URL remota:**\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Remote)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n* **Uso de un archivo local:** (Requiere montar el archivo en el contenedor)\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Local)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-v\",\n \"/full/host/path/to/spec.yaml:/spec/api.yaml\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"/spec/api.yaml\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n **Importante:** Reemplace `/full/host/path/to/spec.yaml` con la ruta absoluta correcta en su equipo host. La ruta `/spec/api.yaml` es la ruta correspondiente dentro del contenedor.\n\n### Método 3: Instalación global (menos común)\n\nSi ha instalado el paquete globalmente usando `npm install -g` , puede configurar su cliente para ejecutarlo directamente.\n\n```bash\n# Run this command once in your terminal\nnpm install -g mcp-openapi-schema-explorer\n```\n\n**Ejemplo de entrada de configuración de cliente (método de instalación global):**\n\nAgregue la siguiente entrada al archivo de configuración de su cliente MCP. Esto supone que el comando `mcp-openapi-schema-explorer` es accesible en la ruta del entorno de ejecución del cliente.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Global)\": {\n \"command\": \"mcp-openapi-schema-explorer\",\n \"args\": [\"\", \"--output-format\", \"yaml\"],\n \"env\": {}\n }\n }\n}\n```\n\n* Asegúrese de que el `command` ( `mcp-openapi-schema-explorer` ) sea accesible en la variable de entorno PATH utilizada por su cliente MCP.\n\n### Método 4: Desarrollo/Instalación Local\n\nEste método es útil si ha clonado el repositorio localmente para desarrollo o para ejecutar una versión modificada.\n\n**Pasos de configuración (Ejecutar una vez en su terminal):**\n\n1. Clonar el repositorio: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`\n2. Navegue al directorio: `cd mcp-openapi-schema-explorer`\n3. Instalar dependencias: `npm install`\n4. Construya el proyecto: `npm run build` (o `just build` )\n\n**Ejemplo de entrada de configuración de cliente (método de desarrollo local):**\n\nAgregue la siguiente entrada al archivo de configuración de su cliente MCP. Esto le indica que ejecute el servidor compilado localmente mediante `node` .\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Local Dev)\": {\n \"command\": \"node\",\n \"args\": [\n \"/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n\n \"env\": {}\n }\n }\n}\n```\n\n**Importante:** reemplace `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js` con la ruta absoluta correcta al archivo `index.js` creado en su repositorio clonado.\n\n## Características\n\n* **Acceso a recursos de MCP:** explore las especificaciones de OpenAPI a través de URI intuitivos ( `openapi://info` , `openapi://paths/...` , `openapi://components/...` ).\n* **Compatibilidad con OpenAPI v3.0 y Swagger v2.0:** carga ambos formatos y convierte automáticamente v2.0 a v3.0.\n* **Archivos locales y remotos:** cargue especificaciones desde rutas de archivos locales o URL HTTP/HTTPS.\n* **Uso eficiente de tokens:** diseñado para minimizar el uso de tokens para LLM al proporcionar acceso estructurado.\n* **Múltiples formatos de salida:** obtenga vistas detalladas en JSON (predeterminado), YAML o JSON minimizado ( `--output-format` ).\n* **Nombre del servidor dinámico:** el nombre del servidor en los clientes MCP refleja el `info.title` de la especificación cargada.\n* **Transformación de referencia:** `$ref` internas ( `#/components/...` ) se transforman en URI de MCP en los que se puede hacer clic.\n\n## Recursos MCP disponibles\n\nEste servidor expone las siguientes plantillas de recursos MCP para explorar la especificación OpenAPI.\n\n**Comprensión de los parámetros multivalor ( `*` )**\n\nAlgunas plantillas de recursos incluyen parámetros que terminan en asterisco ( `*` ), como `{method*}` o `{name*}` . Esto indica que el parámetro acepta **varios valores separados por comas** . Por ejemplo, para solicitar detalles de los métodos `GET` y `POST` de una ruta, se usaría un URI como `openapi://paths/users/get,post` . Esto permite obtener detalles de varios elementos en una sola solicitud.\n\n**Plantillas de recursos:**\n\n* **`openapi://{field}`**\n\n * **Descripción:** Accede a los campos de nivel superior del documento OpenAPI (p. ej., `info` , `servers` , `tags` ) o lista el contenido de `paths` o `components` . Los campos específicos disponibles dependen de la especificación cargada.\n * **Ejemplo:** `openapi://info`\n * **Salida:** lista `text/plain` para `paths` y `components` ; formato configurado (JSON/YAML/JSON minimizado) para otros campos.\n * **Compleciones:** proporciona sugerencias dinámicas para `{field}` en función de las claves de nivel superior reales que se encuentran en la especificación cargada.\n\n* **`openapi://paths/{path}`**\n\n * **Descripción:** enumera los métodos HTTP (operaciones) disponibles para una ruta API específica.\n * **Parámetro:** `{path}` - La cadena de ruta de la API. **Debe estar codificada como URL** (p. ej., `/users/{id}` se convierte en `users%2F%7Bid%7D` ).\n * **Ejemplo:** `openapi://paths/users%2F%7Bid%7D`\n * **Salida:** lista de métodos `text/plain` .\n * **Compleciones:** proporciona sugerencias dinámicas para `{path}` en función de las rutas encontradas en la especificación cargada (codificada en URL).\n\n* **`openapi://paths/{path}/{method*}`**\n\n * **Descripción:** Obtiene la especificación detallada de una o más operaciones (métodos HTTP) en una ruta API específica.\n * **Parámetros:**\n\n * `{path}` - La cadena de ruta de la API. **Debe estar codificada como URL** .\n * `{method*}` - Uno o más métodos HTTP (p. ej., `get` , `post` , `get,post` ). No distingue entre mayúsculas y minúsculas.\n * **Ejemplo (único):** `openapi://paths/users%2F%7Bid%7D/get`\n * **Ejemplo (múltiple):** `openapi://paths/users%2F%7Bid%7D/get,post`\n * **Salida:** Formato configurado (JSON/YAML/JSON minimizado).\n * **Compleciones:** Ofrece sugerencias dinámicas para `{path}` . Ofrece sugerencias estáticas para `{method*}` (verbos HTTP comunes como GET, POST, PUT, DELETE, etc.).\n\n* **`openapi://components/{type}`**\n\n * **Descripción:** Enumera los nombres de todos los componentes definidos de un tipo específico (p. ej., `schemas` , `responses` , `parameters` ). Los tipos específicos disponibles dependen de la especificación cargada. También proporciona una breve descripción de cada tipo listado.\n * **Ejemplo:** `openapi://components/schemas`\n * **Salida:** lista `text/plain` de nombres de componentes con descripciones.\n * **Compleciones:** proporciona sugerencias dinámicas para `{type}` en función de los tipos de componentes encontrados en la especificación cargada.\n\n* **`openapi://components/{type}/{name*}`**\n\n * **Descripción:** Obtiene la especificación detallada de uno o más componentes nombrados de un tipo específico.\n * **Parámetros:**\n\n * `{type}` - El tipo de componente.\n * `{name*}` - Uno o más nombres de componentes (p. ej., `User` , `Order` , `User,Order` ). Distingue entre mayúsculas y minúsculas.\n * **Ejemplo (único):** `openapi://components/schemas/User`\n * **Ejemplo (múltiple):** `openapi://components/schemas/User,Order`\n * **Salida:** Formato configurado (JSON/YAML/JSON minimizado).\n * **Compleciones:** Proporciona sugerencias dinámicas para `{type}` . Proporciona sugerencias dinámicas para `{name*}`*solo si* la especificación cargada contiene exactamente un tipo de componente (p. ej., solo `schemas` ). Esta limitación existe porque el SDK de MCP actualmente no permite proporcionar compleciones con el alcance del `{type}` seleccionado; proporcionar todos los nombres de todos los tipos podría ser engañoso.\n\n## Contribuyendo\n\n¡Agradecemos sus contribuciones! Consulte el archivo [CONTRIBUTING.md](CONTRIBUTING.md) para obtener instrucciones sobre cómo configurar el entorno de desarrollo, ejecutar pruebas y enviar cambios.\n\n## Lanzamientos\n\nEste proyecto utiliza [`semantic-release`](https://github.com/semantic-release/semantic-release) para la gestión automatizada de versiones y la publicación de paquetes basada en [confirmaciones convencionales](https://www.conventionalcommits.org/) .\n\n## Planes futuros\n\n(Planes futuros por determinar)","Spanish","es-ES",{"_27":52,"_31":56,"_36":57},{"_29":53,"_31":54,"_33":55},"クライアント側の探索のために、MCP リソースを介して OpenAPI/Swagger 仕様へのトークン効率の高いアクセスを提供する MCP サーバー。","OpenAPI スキーマエクスプローラー","# MCP OpenAPI スキーマエクスプローラー\n\n[![npmバージョン](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![NPMダウンロード](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![Dockerプル](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer) [![ライセンス: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![コードコフ](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer) [![MseePで検証済み](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)\n\n**MCP リソース**を介して OpenAPI (v3.0) および Swagger (v2.0) 仕様へのトークン効率の高いアクセスを提供する MCP (モデルコンテキストプロトコル) サーバー。\n\n## プロジェクトの目標\n\nこのプロジェクトの主目的は、MCPクライアント（ClineやClaude Desktopなど）が、LLMのコンテキストウィンドウにファイル全体を読み込むことなく、大規模なOpenAPI仕様の構造と詳細を探索できるようにすることです。これは、読み取り専用のデータ探索に適したMCPリソースを通じて仕様の一部を公開することで実現します。\n\nこのサーバーは、ローカルファイルパスとリモートHTTP/HTTPS URLの両方からの仕様の読み込みをサポートしています。Swagger v2.0仕様は、読み込み時に自動的にOpenAPI v3.0に変換されます。\n\n## MCP リソースを選ぶ理由\n\nモデルコンテキストプロトコルは、**リソース**と**ツールの**両方を定義します。\n\n* \\*\\*リソース:\\*\\*データソース（ファイル、APIレスポンスなど）を表します。MCPクライアントによる読み取り専用アクセスや探索（例：Claude DesktopでのAPIパスの参照）に最適です。\n* \\*\\*ツール:\\*\\*実行可能なアクションまたは機能を表します。LLM がタスクを実行したり外部システムと対話したりする際によく使用されます。\n\n*ツール*経由でOpenAPI仕様へのアクセスを提供するMCPサーバーは他にも存在しますが、このプロジェクトは*リソース*経由でのアクセス提供に特化しています。そのため、MCPクライアントアプリケーション内で直接探索する場合に特に便利です。\n\nMCP クライアントとその機能の詳細については、 [MCP クライアントのドキュメントを](https://modelcontextprotocol.io/clients)参照してください。\n\n## インストール\n\n推奨される使用方法（以下で説明する`npx`とDocker）では、**別途インストール手順は必要ありません**。MCPクライアントは、指定された設定に基づいてパッケージをダウンロードするか、Dockerイメージを自動的にプルします。\n\nただし、サーバーを明示的にインストールしたい場合やインストールする必要がある場合は、次の 2 つのオプションがあります。\n\n1. **グローバルインストール:** npm を使用してパッケージをグローバルにインストールできます。\n\n ```bash\n npm install -g mcp-openapi-schema-explorer\n ```\n\n グローバルにインストールされたサーバーを使用するように MCP クライアントを構成する方法については、以下の**方法 3 を**参照してください。\n\n2. \\*\\*ローカル開発/インストール:\\*\\*リポジトリをクローンしてローカルでビルドできます。\n\n ```bash\n git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git\n cd mcp-openapi-schema-explorer\n npm install\n npm run build\n ```\n\n `node`を使用してローカルビルドからサーバーを実行するように MCP クライアントを構成する方法については、以下の**方法 4 を**参照してください。\n\n## MCPクライアントにサーバーを追加する\n\nこのサーバーは、MCPクライアント（Claude Desktop、Windsurf、Clineなど）で実行されるように設計されています。使用するには、クライアントの設定ファイル（通常はJSONファイル）に設定エントリを追加します。このエントリは、クライアントにサーバープロセスの実行方法（例： `npx` 、 `docker` 、 `node`など）を指示します。サーバー自体は、クライアント設定エントリで指定されたコマンドライン引数以外に、別途設定する必要はありません。\n\n以下は、クライアントの構成にサーバーエントリを追加するための一般的な方法です。\n\n### 方法1: npx (推奨)\n\nグローバル/ローカルインストールを回避し、クライアントが最新の公開バージョンを使用することを保証するため、 `npx`の使用が推奨されます。\n\n**クライアント構成エントリの例 (npx メソッド):**\n\nMCPクライアントの設定ファイルの`mcpServers`セクションに、以下のJSONオブジェクトを追加します。このエントリは、 `npx`を使用してサーバーを実行する方法をクライアントに指示します。\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (npx)\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-openapi-schema-explorer@latest\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n}\n```\n\n**構成に関する注意事項:**\n\n* `\"My API Spec (npx)\"`を、クライアント内のこのサーバーインスタンスの一意の名前に置き換えます。\n* `` 、仕様の絶対ローカルファイルパスまたは完全なリモート URL に置き換えます。\n* `--output-format`はオプション ( `json` 、 `yaml` 、 `json-minified` ) で、デフォルトは`json`です。\n* 複数の仕様を調べるには、 `mcpServers`に個別のエントリを追加し、それぞれに一意の名前を付けて、異なる仕様を指します。\n\n### 方法2: Docker\n\n公式 Docker イメージ`kadykov/mcp-openapi-schema-explorer`を使用して、MCP クライアントにサーバーを実行するように指示できます。\n\n**クライアント構成エントリの例 (Docker メソッド):**\n\nMCPクライアントの設定ファイルの`mcpServers`セクションに、以下のJSONオブジェクトのいずれかを追加します。これらのエントリは、 `docker run`を使用してサーバーを実行する方法をクライアントに指示します。\n\n* **リモート URL:** URL を`docker run`に直接渡します。\n\n* **リモート URL の使用:**\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Remote)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n* **ローカルファイルの使用:** (ファイルをコンテナにマウントする必要があります)\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Local)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-v\",\n \"/full/host/path/to/spec.yaml:/spec/api.yaml\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"/spec/api.yaml\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n **重要:** `/full/host/path/to/spec.yaml`をホストマシン上の正しい絶対パスに置き換えてください。/spec/api.yaml `/spec/api.yaml`コンテナ内の対応するパスです。\n\n### 方法3: グローバルインストール（あまり一般的ではない）\n\n`npm install -g`を使用してパッケージをグローバルにインストールした場合は、クライアントが直接実行するように構成できます。\n\n```bash\n# Run this command once in your terminal\nnpm install -g mcp-openapi-schema-explorer\n```\n\n**クライアント構成エントリの例 (グローバルインストール方法):**\n\nMCPクライアントの設定ファイルに以下のエントリを追加します。これは`mcp-openapi-schema-explorer`コマンドがクライアントの実行環境PATHでアクセス可能であることを前提としています。\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Global)\": {\n \"command\": \"mcp-openapi-schema-explorer\",\n \"args\": [\"\", \"--output-format\", \"yaml\"],\n \"env\": {}\n }\n }\n}\n```\n\n* MCP クライアントが使用する PATH 環境変数で`command` ( `mcp-openapi-schema-explorer` ) にアクセスできることを確認します。\n\n### 方法4: ローカル開発/インストール\n\nこの方法は、開発のためにリポジトリをローカルに複製した場合や、変更されたバージョンを実行した場合に便利です。\n\n**セットアップ手順 (ターミナルで 1 回実行):**\n\n1. リポジトリをクローンします: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`\n2. ディレクトリに移動します: `cd mcp-openapi-schema-explorer`\n3. 依存関係をインストール: `npm install`\n4. プロジェクトをビルドします: `npm run build` (または`just build` )\n\n**クライアント構成エントリの例 (ローカル開発方法):**\n\nMCPクライアントの設定ファイルに以下のエントリを追加します。これにより、クライアントはローカルで構築されたサーバーを`node`を使って実行するよう指示されます。\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Local Dev)\": {\n \"command\": \"node\",\n \"args\": [\n \"/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n\n \"env\": {}\n }\n }\n}\n```\n\n**重要:** `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js`を、クローンされたリポジトリに構築された`index.js`ファイルへの正しい絶対パスに置き換えます。\n\n## 特徴\n\n* \\*\\*MCP リソースアクセス:\\*\\*直感的な URI ( `openapi://info` 、 `openapi://paths/...` 、 `openapi://components/...` ) を介して OpenAPI 仕様を調べます。\n* \\*\\*OpenAPI v3.0 および Swagger v2.0 のサポート:\\*\\*両方の形式を読み込み、v2.0 を v3.0 に自動的に変換します。\n* \\*\\*ローカルおよびリモートファイル:\\*\\*ローカルファイルパスまたは HTTP/HTTPS URL から仕様を読み込みます。\n* \\*\\*トークン効率:\\*\\*構造化されたアクセスを提供することで、LLM のトークン使用量を最小限に抑えるように設計されています。\n* **複数の出力形式:** JSON (デフォルト)、YAML、または縮小された JSON ( `--output-format` ) で詳細ビューを取得します。\n* **動的サーバー名:** MCP クライアントのサーバー名は、読み込まれた仕様の`info.title`を反映します。\n* \\*\\*参照変換:\\*\\*内部の`$ref` ( `#/components/...` ) はクリック可能な MCP URI に変換されます。\n\n## 利用可能なMCPリソース\n\nこのサーバーは、OpenAPI 仕様を調べるための次の MCP リソーステンプレートを公開します。\n\n**複数値パラメータの理解（ `*` ）**\n\n一部のリソーステンプレートには、 `{method*}`や`{name*}`のように、アスタリスク（ `*` ）で終わるパラメータが含まれています。これは、パラメータ**が複数のコンマ区切り値**を受け入れることを示します。例えば、パスの`GET`メソッドと`POST`メソッドの両方の詳細を要求するには、 `openapi://paths/users/get,post`のようなURIを使用します。これにより、1回のリクエストで複数の項目の詳細を取得できます。\n\n**リソーステンプレート:**\n\n* **`openapi://{field}`**\n\n * **説明:** OpenAPIドキュメントの最上位フィールド（例： `info` 、 `servers` 、 `tags` ）にアクセスするか、 `paths`または`components`の内容を一覧表示します。使用可能なフィールドは、読み込まれた仕様によって異なります。\n * **例:** `openapi://info`\n * **出力:** `paths`と`components`の場合は`text/plain`リスト、その他のフィールドの場合は構成された形式 (JSON/YAML/縮小された JSON)。\n * \\*\\*補完:\\*\\*読み込まれた仕様で見つかった実際のトップレベルキーに基づいて、 `{field}`の動的な提案を提供します。\n\n* **`openapi://paths/{path}`**\n\n * \\*\\*説明:\\*\\*特定の API パスで使用可能な HTTP メソッド (操作) を一覧表示します。\n * **パラメータ:** `{path}` - APIパス文字列。URL**エンコードする必要があります**（例： `/users/{id}``users%2F%7Bid%7D`になります）。\n * **例:** `openapi://paths/users%2F%7Bid%7D`\n * \\*\\*出力:\\*\\*メソッドの`text/plain`リスト。\n * \\*\\*補完:\\*\\*読み込まれた仕様 (URL エンコード) で見つかったパスに基づいて、 `{path}`の動的な提案を提供します。\n\n* **`openapi://paths/{path}/{method*}`**\n\n * \\*\\*説明:\\*\\*特定の API パス上の 1 つ以上の操作 (HTTP メソッド) の詳細な仕様を取得します。\n * **パラメータ:**\n\n * `{path}` - API パス文字列。URL**エンコードされている必要があります**。\n * `{method*}` - 1つ以上のHTTPメソッド（例： `get` 、 `post` 、 `get,post` ）。大文字と小文字は区別されません。\n * **例（単一）:** `openapi://paths/users%2F%7Bid%7D/get`\n * **例（複数）:** `openapi://paths/users%2F%7Bid%7D/get,post`\n * \\*\\*出力:\\*\\*構成された形式 (JSON/YAML/縮小された JSON)。\n * **補完:** `{path}`に対して動的な候補を表示します。 `{method*}` (GET、POST、PUT、DELETE などの一般的な HTTP 動詞) に対しては静的な候補を表示します。\n\n* **`openapi://components/{type}`**\n\n * \\*\\*説明:\\*\\*特定のタイプ（例： `schemas` 、 `responses` 、 `parameters` ）の定義済みコンポーネントの名前をすべて一覧表示します。使用可能なタイプは、読み込まれた仕様によって異なります。また、各タイプには簡単な説明も表示されます。\n * **例:** `openapi://components/schemas`\n * \\*\\*出力:\\*\\*コンポーネント名と説明の`text/plain`リスト。\n * \\*\\*補完:\\*\\*読み込まれた仕様で見つかったコンポーネントタイプに基づいて、 `{type}`の動的な提案を提供します。\n\n* **`openapi://components/{type}/{name*}`**\n\n * \\*\\*説明:\\*\\*特定のタイプの 1 つ以上の名前付きコンポーネントの詳細な仕様を取得します。\n * **パラメータ:**\n\n * `{type}` - コンポーネントの種類。\n * `{name*}` - 1つ以上のコンポーネント名（例： `User` 、 `Order` 、 `User,Order` ）。大文字と小文字が区別されます。\n * **例（単一）:** `openapi://components/schemas/User`\n * **例（複数）:** `openapi://components/schemas/User,Order`\n * \\*\\*出力:\\*\\*構成された形式 (JSON/YAML/縮小された JSON)。\n * **補完:** `{type}`に対して動的な候補を提供します。 `{name*}`に対しては、読み込まれた仕様にコンポーネントタイプが1つだけ含まれている*場合*（例： `schemas`のみ）にのみ、動的な候補を提供します。この制限は、MCP SDKが現在、選択された`{type}`をスコープとした補完の提供をサポートしていないためです。すべてのタイプにわたるすべての名前を提供すると、誤解を招く可能性があります。\n\n## 貢献\n\n貢献を歓迎します！開発環境の設定、テストの実行、変更の送信に関するガイドラインについては、 [CONTRIBUTING.md](CONTRIBUTING.md)ファイルをご覧ください。\n\n## リリース\n\nこのプロジェクトでは、 [Conventional Commits](https://www.conventionalcommits.org/)に基づく自動バージョン管理とパッケージ公開に[`semantic-release`](https://github.com/semantic-release/semantic-release)を使用します。\n\n## 今後の計画\n\n（今後の予定は未定）","Japanese","ja-JP",{"_27":59,"_31":63,"_36":64},{"_29":60,"_31":61,"_33":62},"MCP 리소스를 통해 클라이언트 측 탐색을 위한 OpenAPI/Swagger 사양에 대한 토큰 효율적인 액세스를 제공하는 MCP 서버입니다.","OpenAPI 스키마 탐색기","# MCP OpenAPI 스키마 탐색기\n\n[![npm 버전](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![NPM 다운로드](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![도커 풀](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer) [![라이센스: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![코드코브](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer) [![MseeP에서 확인됨](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)\n\n**MCP 리소스를** 통해 OpenAPI(v3.0) 및 Swagger(v2.0) 사양에 대한 토큰 효율적인 액세스를 제공하는 MCP(Model Context Protocol) 서버입니다.\n\n## 프로젝트 목표\n\n이 프로젝트의 주요 목표는 MCP 클라이언트(예: Cline 또는 Claude Desktop)가 전체 파일을 LLM 컨텍스트 창에 로드하지 않고도 대규모 OpenAPI 사양의 구조와 세부 정보를 탐색할 수 있도록 하는 것입니다. 읽기 전용 데이터 탐색에 적합한 MCP 리소스를 통해 사양의 일부를 공개함으로써 이를 달성합니다.\n\n이 서버는 로컬 파일 경로와 원격 HTTP/HTTPS URL 모두에서 사양 로딩을 지원합니다. Swagger v2.0 사양은 로딩 시 OpenAPI v3.0으로 자동 변환됩니다.\n\n## 왜 MCP Resources인가요?\n\n모델 컨텍스트 프로토콜은 **리소스** 와 **도구를** 모두 정의합니다.\n\n* **리소스:** 데이터 소스(파일, API 응답 등)를 나타냅니다. MCP 클라이언트의 읽기 전용 ��세스 및 탐색(예: Claude Desktop에서 API 경로 탐색)에 적합합니다.\n* **도구:** LLM이 작업을 수행하거나 외부 시스템과 상호 작용하는 데 자주 사용되는 실행 가능한 동작이나 기능을 나타냅니다.\n\n*Tools를* 통해 OpenAPI 사양에 대한 액세스를 제공하는 다른 MCP 서버도 있지만, 이 프로젝트는 *Resources를* 통해 액세스를 제공하는 데 중점을 둡니다. 따라서 MCP 클라이언트 애플리케이션 내에서 직접 탐색하는 데 특히 유용합니다.\n\nMCP 클라이언트와 해당 기능에 대한 자세한 내용은 [MCP 클라이언트 설명서를](https://modelcontextprotocol.io/clients) 참조하세요.\n\n## 설치\n\n권장 사용 방법(아래에 설명된 `npx` 및 Docker)의 경우 **별도의 설치 단계가 필요하지 않습니다** . MCP 클라이언트는 사용자가 제공한 구성에 따라 자동으로 패키지를 다운로드하거나 Docker 이미지를 가져옵니다.\n\n하지만 서버를 명시적으로 설치해야 하거나 선호한다면 두 가지 옵션이 있습니다.\n\n1. **글로벌 설치:** npm을 사용하여 패키지를 글로벌하게 설치할 수 있습니다.\n\n 지엑스피1\n\n 글로벌하게 설치된 서버를 사용하도록 MCP 클라이언트를 구성하는 방법은 아래의 **방법 3을** 참조하세요.\n\n2. **로컬 개발/설치:** 저장소를 복제하여 로컬로 빌드할 수 있습니다.\n\n ```bash\n git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git\n cd mcp-openapi-schema-explorer\n npm install\n npm run build\n ```\n\n 로컬 빌드에서 `node` 사용하여 서버를 실행하도록 MCP 클라이언트를 구성하는 방법은 아래의 **방법 4를** 참조하세요.\n\n## MCP 클라이언트에 서버 추가\n\n이 서버는 MCP 클라이언트(예: Claude Desktop, Windsurf, Cline 등)에서 실행되도록 설계되었습니다. 사용하려면 클라이언트 설정 파일(주로 JSON 파일)에 구성 항목을 추가해야 합니다. 이 항목은 클라이언트에게 서버 프로세스를 실행하는 방법(예: `npx` , `docker` 또는 `node` 사용)을 알려줍니다. 서버 자체는 클라이언트 설정 항목에 지정된 명령줄 인수 외에 별도의 구성이 필요하지 않습니다.\n\n클라이언트 구성에 서버 항목을 추가하는 일반적인 방법은 다음과 같습니다.\n\n### 방법 1: npx (권장)\n\n`npx` 사용하면 글로벌/로컬 설치가 필요 없고 클라이언트가 최신 게시 버전을 사용하게 되므로 권장됩니다.\n\n**예제 클라이언트 구성 항목(npx 방법):**\n\nMCP 클라이언트 구성 파일의 `mcpServers` 섹션에 다음 JSON 객체를 추가하세요. 이 항목은 클라이언트에게 `npx` 사용하여 서버를 실행하는 방법을 알려줍니다.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (npx)\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-openapi-schema-explorer@latest\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n}\n```\n\n**구성 참고 사항:**\n\n* 클라이언트에서 `\"My API Spec (npx)\"` 이 서버 인스턴스의 고유한 이름으로 바꾸세요.\n* `` 사양의 절대 로컬 파일 경로 또는 전체 원격 URL로 바꾸세요.\n* `--output-format` 선택 사항( `json` , `yaml` , `json-minified` )이며, 기본값은 `json` 입니다.\n* 여러 사양을 탐색하려면 `mcpServers` 에 각각 고유한 이름을 지정하고 다른 사양을 가리키는 별도 항목을 추가합니다.\n\n### 방법 2: Docker\n\n공식 Docker 이미지인 `kadykov/mcp-openapi-schema-explorer` 사용하여 MCP 클라이언트가 서버를 실행하도록 지시할 수 있습니다.\n\n**클라이언트 구성 항목 예시(Docker 방법):**\n\nMCP 클라이언트 구성 파일의 `mcpServers` 섹션에 다음 JSON 객체 중 하나를 추가하세요. 이 항목들은 클라이언트에게 `docker run` 사용하여 서버를 실행하는 방법을 알려줍니다.\n\n* **원격 URL:** `docker run` 에 URL을 직접 전달합니다.\n\n* **원격 URL 사용:**\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Remote)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n* **로컬 파일 사용:** (컨테이너에 파일을 마운트해야 함)\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Local)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-v\",\n \"/full/host/path/to/spec.yaml:/spec/api.yaml\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"/spec/api.yaml\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n **중요:** `/full/host/path/to/spec.yaml` 호스트 머신의 올바른 절대 경로로 바꾸세요. `/spec/api.yaml` 경로는 컨테이너 내부의 해당 경로입니다.\n\n### 방법 3: 글로벌 설치(덜 일반적)\n\n`npm install -g` 사용하여 패키지를 전역으로 설치한 경우 클라이언트를 구성하여 해당 패키지를 직접 실행할 수 있습니다.\n\n```bash\n# Run this command once in your terminal\nnpm install -g mcp-openapi-schema-explorer\n```\n\n**클라이언트 구성 항목 예(전역 설치 방법):**\n\nMCP 클라이언트 구성 파일에 다음 항목을 추가하세요. 이는 `mcp-openapi-schema-explorer` 명령이 클라이언트 실행 환경 PATH에서 접근 가능하다는 것을 전제로 합니다.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Global)\": {\n \"command\": \"mcp-openapi-schema-explorer\",\n \"args\": [\"\", \"--output-format\", \"yaml\"],\n \"env\": {}\n }\n }\n}\n```\n\n* MCP 클라이언트에서 사용하는 PATH 환경 변수에서 `command` ( `mcp-openapi-schema-explorer` )에 액세스할 수 있는지 확인하세요.\n\n### 방법 4: 로컬 개발/설치\n\n이 방법은 개발을 위해 로컬로 저장소를 복제한 경우나 수정된 버전을 실행하려는 경우에 유용합니다.\n\n**설정 단계(터미널에서 한 번 실행):**\n\n1. 저장소를 복제합니다: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`\n2. 디렉토리로 이동합니다: `cd mcp-openapi-schema-explorer`\n3. 종속성 설치: `npm install`\n4. 프로젝트 빌드: `npm run build` (또는 `just build` )\n\n**클라이언트 구성 항목 예시(로컬 개발 방법):**\n\nMCP 클라이언트 구성 파일에 다음 항목을 추가하세요. 이 항목은 클라이언트가 `node` 사용하여 로컬로 빌드한 서버를 실행하도록 지시합니다.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Local Dev)\": {\n \"command\": \"node\",\n \"args\": [\n \"/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n\n \"env\": {}\n }\n }\n}\n```\n\n**중요:** `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js` 복제된 저장소에 있는 빌드된 `index.js` 파일의 올바른 절대 경로로 바꾸세요.\n\n## 특징\n\n* **MCP 리소스 액세스:** 직관적인 URI( `openapi://info` , `openapi://paths/...` , `openapi://components/...` )를 통해 OpenAPI 사양을 살펴보세요.\n* **OpenAPI v3.0 및 Swagger v2.0 지원:** 두 형식을 모두 로드하고 v2.0을 v3.0으로 자동 변환합니다.\n* **로컬 및 원격 파일:** 로컬 파일 경로 또는 HTTP/HTTPS URL에서 사양을 로드합니다.\n* **토큰 효율성:** 구조화된 액세스를 제공하여 LLM의 토큰 사용을 최소화하도록 설계되었습니다.\n* **다양한 출력 형식:** JSON(기본값), YAML 또는 축소된 JSON( `--output-format` ) 형식으로 자세한 보기를 가져옵니다.\n* **동적 서버 이름:** MCP 클라이언트의 서버 이름은 로드된 사양의 `info.title` 반영합니다.\n* **참조 변환:** 내부 `$ref` ( `#/components/...` )는 클릭 가능한 MCP URI로 변환됩니다.\n\n## 사용 가능한 MCP 리소스\n\n이 서버는 OpenAPI 사양을 탐색하기 위한 다음 MCP 리소스 템플릿을 제공합니다.\n\n**다중 값 매개변수 이해( `*` )**\n\n일부 리소스 템플릿에는 `{method*}` 또는 `{name*}` 처럼 별표( `*` )로 끝나는 매개변수가 포함되어 있습니다. 이는 매개변수가 **쉼표로 구분된 여러 값을** 허용함을 나타냅니다. 예를 들어, 경로의 `GET` 및 `POST` 메서드에 대한 세부 정보를 모두 요청하려면 `openapi://paths/users/get,post` 와 같은 URI를 사용합니다. 이렇게 하면 단일 요청으로 여러 항목에 대한 세부 정보를 가져올 수 있습니다.\n\n**리소스 템플릿:**\n\n* **`openapi://{field}`**\n\n * **설명:** OpenAPI 문서의 최상위 필드(예: `info` , `servers` , `tags` )에 접근하거나 `paths` 또는 `components` 의 내용을 나열합니다. 사용 가능한 필드는 로드된 사양에 따라 달라집니다.\n * **예:** `openapi://info`\n * **출력:** `paths` 및 `components` 에 대한 `text/plain` 목록, 기타 필드에 대한 구성된 형식(JSON/YAML/최소화된 JSON).\n * **완성:** 로드된 사양에서 발견된 실제 최상위 키를 기반으로 `{field}` 에 대한 동적 제안을 제공합니다.\n\n* **`openapi://paths/{path}`**\n\n * **설명:** 특정 API 경로에 대해 사용 가능한 HTTP 메서드(작업)를 나열합니다.\n * **매개변수:** `{path}` - API 경로 문자열입니다. **URL로 인코딩되어야 합니다** (예: `/users/{id}``users%2F%7Bid%7D` 가 됩니다).\n * **예:** `openapi://paths/users%2F%7Bid%7D`\n * **출력:** 메서드의 `text/plain` 목록입니다.\n * **완성:** 로드된 사양(URL 인코딩)에서 발견된 경로를 기반으로 `{path}` 에 대한 동적 제안을 제공합니다.\n\n* **`openapi://paths/{path}/{method*}`**\n\n * **설명:** 특정 API 경로에 대한 하나 이상의 작업(HTTP 메서드)에 대한 자세한 사양을 가져옵니다.\n * **매개변수:**\n\n * `{path}` - API 경로 문자열입니다. **URL로 인코딩되어야 합니다** .\n * `{method*}` - 하나 이상의 HTTP 메서드(예: `get` , `post` , `get,post` ). 대소문자를 구분하지 않습니다.\n * **예(단일):** `openapi://paths/users%2F%7Bid%7D/get`\n * **예(다중):** `openapi://paths/users%2F%7Bid%7D/get,post`\n * **출력:** 구성된 형식(JSON/YAML/최소화된 JSON).\n * **완성:** `{path}` 에 대한 동적 제안을 제공합니다. `{method*}` (GET, POST, PUT, DELETE 등 일반적인 HTTP 동사)에 대한 정적 제안을 제공합니다.\n\n* **`openapi://components/{type}`**\n\n * **설명:** 특정 유형의 정의된 모든 구성 요소(예: `schemas` , `responses` , `parameters` )의 이름을 나열합니다. 사용 가능한 구체적인 유형은 로드된 사양에 따라 달라집니다. 또한 나열된 각 유형에 대한 간략한 설명을 제공합니다.\n * **예:** `openapi://components/schemas`\n * **출력:** 설명이 포함된 구성 요소 이름의 `text/plain` 목록입니다.\n * **완성:** 로드된 사양에서 발견된 구성 요소 유형을 기반으로 `{type}` 에 대한 동적 제안을 제공합니다.\n\n* **`openapi://components/{type}/{name*}`**\n\n * **설명:** 특정 유형의 하나 이상의 명명된 구성 요소에 대한 자세한 사양을 가져옵니다.\n * **매개변수:**\n\n * `{type}` - 구성 요소 유형입니다.\n * `{name*}` - 하나 이상의 구성 요소 이름(예: `User` , `Order` , `User,Order` ). 대소문자를 구분합니다.\n * **예(단일):** `openapi://components/schemas/User`\n * **예(다중):** `openapi://components/schemas/User,Order`\n * **출력:** 구성된 형식(JSON/YAML/최소화된 JSON).\n * **완성:** `{type}` 에 대한 동적 제안을 제공합니다. 로드된 사양에 전체적으로 단 하나의 구성 요소 유형(예: `schemas` 만)만 포함된 *경우에만* `{name*}` 에 대한 동적 제안을 제공합니다. 이러한 제한은 MCP SDK가 현재 선택된 `{type}` 에 대한 완성 제공을 지원하지 않기 때문에 발생합니다. 모든 유형의 모든 이름을 제공하면 오해의 소지가 있을 수 있습니다.\n\n## 기여하다\n\n기여를 환영합니다! 개발 환경 설정, 테스트 실행, 변경 사항 제출에 대한 지침은 [CONTRIBUTING.md](CONTRIBUTING.md) 파일을 참조하세요.\n\n## 출시\n\n이 프로젝트에서는 [Conventional Commit을](https://www.conventionalcommits.org/) 기반으로 한 자동화된 버전 관리 및 패키지 게시를 위해 [`semantic-release`](https://github.com/semantic-release/semantic-release) 사용합니다.\n\n## 미래 계획\n\n(향후 계획은 추후 결정)","Korean","ko-KR",{"_27":66,"_31":70,"_36":71},{"_29":67,"_31":68,"_33":69},"Сервер MCP, обеспечивающий эффективный доступ к спецификациям OpenAPI/Swagger через ресурсы MCP для исследования на стороне клиента.","Проводник схем OpenAPI","# MCP OpenAPI Обозреватель схем\n\n[![npm-версия](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![Загрузки НПМ](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![Докер тянет](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer) [![Лицензия: Массачусетский технологический институт](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![кодеков](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer) [![Проверено на MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)\n\nСервер MCP (Model Context Protocol), который обеспечивает эффективный доступ к спецификациям OpenAPI (v3.0) и Swagger (v2.0) через **ресурсы MCP** .\n\n## Цель проекта\n\nОсновная цель этого проекта — позволить клиентам MCP (например, Cline или Claude Desktop) исследовать структуру и детали больших спецификаций OpenAPI без необходимости загружать весь файл в контекстное окно LLM. Это достигается путем предоставления частей спецификации через ресурсы MCP, которые хорошо подходят для исследования данных только для чтения.\n\nЭтот сервер поддерживает загрузку спецификаций как из локальных путей файлов, так и из удаленных HTTP/HTTPS URL. Спецификации Swagger v2.0 автоматически преобразуются в OpenAPI v3.0 при загрузке.\n\n## Почему MCP Resources?\n\nПротокол контекста модели определяет как **ресурсы** , так и **инструменты** .\n\n* **Ресурсы:** представляют источники данных (например, файлы, ответы API). Они идеально подходят для доступа только для чтения и исследования клиентами MCP (например, просмотр путей API в Claude Desktop).\n* **Инструменты:** представляют собой исполняемые действия или функции, часто используемые магистрами права для выполнения задач или взаимодействия с внешними системами.\n\nХотя существуют и другие серверы MCP, которые предоставляют доступ к спецификациям OpenAPI через *Tools* , этот проект специально фокусируется на предоставлении доступа через *Resources* . Это делает его особенно полезным для прямого исследования в клиентских приложениях MCP.\n\nБолее подробную информацию о клиентах MCP и их возможностях см. [в документации по клиентам MCP](https://modelcontextprotocol.io/clients) .\n\n## Установка\n\nДля рекомендуемых методов использования ( `npx` и Docker, описанных ниже) **не требуется отдельного шага установки** . Ваш клиент MCP загрузит пакет или извлечет образ Docker автоматически на основе предоставленной вами конфигурации.\n\nОднако, если вы предпочитаете или вам необходимо установить сервер отдельно, у вас есть два варианта:\n\n1. **Глобальная установка:** Вы можете установить пакет глобально с помощью npm:\n\n ```bash\n npm install -g mcp-openapi-schema-explorer\n ```\n\n См. **Метод 3** ниже, чтобы узнать, как настроить клиент MCP для использования глобально установленного сервера.\n\n2. **Локальная разработка/установка:** вы можете клонировать репозиторий и собрать его локально:\n\n ```bash\n git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git\n cd mcp-openapi-schema-explorer\n npm install\n npm run build\n ```\n\n См. **Метод 4** ниже, чтобы узнать, как настроить клиент MCP для запуска сервера из локальной сборки с помощью `node` .\n\n## Добавление сервера к вашему MCP-клиенту\n\nЭтот сервер предназначен для запуска клиентами MCP (например, Claude Desktop, Windsurf, Cline и т. д.). Чтобы использовать его, вы добавляете запись конфигурации в файл настроек клиента (часто файл JSON). Эта запись сообщает клиенту, как выполнять процесс сервера (например, с помощью `npx` , `docker` или `node` ). Сам сервер не требует отдельной настройки, кроме аргументов командной строки, указанных в записи настроек клиента.\n\nНиже приведены распространенные методы добавления записи сервера в конфигурацию вашего клиента.\n\n### Метод 1: npx (рекомендуется)\n\nРекомендуется использовать `npx` , поскольку это позволяет избежать глобальной/локальной установки и гарантирует, что клиент использует последнюю опубликованную версию.\n\n**Пример записи конфигурации клиента (метод npx):**\n\nДобавьте следующий объект JSON в раздел `mcpServers` файла конфигурации вашего клиента MCP. Эта запись инструктирует клиента о том, как запустить сервер с помощью `npx` :\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (npx)\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-openapi-schema-explorer@latest\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n}\n```\n\n**Примечания по конфигурации:**\n\n* Замените `\"My API Spec (npx)\"` на уникальное имя для этого экземпляра сервера в вашем клиенте.\n* Замените `` на абсолютный локальный путь к файлу или полный удаленный URL-адрес вашей спецификации.\n* `--output-format` необязателен ( `json` , `yaml` , `json-minified` ), по умолчанию используется `json` .\n* Чтобы изучить несколько спецификаций, добавьте отдельные записи в `mcpServers` , каждая из которых имеет уникальное имя и указывает на отдельную спецификацию.\n\n### Метод 2: Докер\n\nВы можете указать своему клиенту MCP запустить сервер, используя официальный образ Docker: `kadykov/mcp-openapi-schema-explorer` .\n\n**Примеры записей конфигурации клиента (метод Docker):**\n\nДобавьте один из следующих объектов JSON в раздел `mcpServers` файла конфигурации вашего клиента MCP. Эти записи инструктируют клиента о том, как запустить сервер с помощью `docker run` :\n\n* **Удаленный URL:** Передайте URL-адрес непосредственно в `docker run` .\n\n* **Использование удаленного URL:**\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Remote)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n* **Использование локального файла:** (требуется монтирование файла в контейнер)\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Local)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-v\",\n \"/full/host/path/to/spec.yaml:/spec/api.yaml\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"/spec/api.yaml\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n **Важно:** замените `/full/host/path/to/spec.yaml` на правильный абсолютный путь на вашей хост-машине. Путь `/spec/api.yaml` — это соответствующий путь внутри контейнера.\n\n### Метод 3: Глобальная установка (менее распространённый)\n\nЕсли вы установили пакет глобально с помощью `npm install -g` , вы можете настроить клиент для его непосредственного запуска.\n\n```bash\n# Run this command once in your terminal\nnpm install -g mcp-openapi-schema-explorer\n```\n\n**Пример записи конфигурации клиента (метод глобальной установки):**\n\nДобавьте следующую запись в файл конфигурации вашего клиента MCP. Это предполагает, что команда `mcp-openapi-schema-explorer` доступна в среде выполнения PATH клиента.\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Global)\": {\n \"command\": \"mcp-openapi-schema-explorer\",\n \"args\": [\"\", \"--output-format\", \"yaml\"],\n \"env\": {}\n }\n }\n}\n```\n\n* Убедитесь, что `command` ( `mcp-openapi-schema-explorer` ) доступна в переменной среды PATH, используемой вашим клиентом MCP.\n\n### Метод 4: Локальная разработка/установка\n\nЭтот метод полезен, если вы клонировали репозиторий локально для разработки или запуска измененной версии.\n\n**Шаги настройки (запустите один раз в терминале):**\n\n1. Клонируйте репозиторий: `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`\n2. Перейдите в каталог: `cd mcp-openapi-schema-explorer`\n3. Установка зависимостей: `npm install`\n4. Соберите проект: `npm run build` (или `just build` )\n\n**Пример записи конфигурации клиента (локальный метод разработки):**\n\nДобавьте следующую запись в файл конфигурации вашего клиента MCP. Это предписывает клиенту запустить локально созданный сервер с помощью `node` .\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Local Dev)\": {\n \"command\": \"node\",\n \"args\": [\n \"/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n\n \"env\": {}\n }\n }\n}\n```\n\n**Важно:** замените `/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js` на правильный абсолютный путь к созданному файлу `index.js` в клонированном репозитории.\n\n## Функции\n\n* **Доступ к ресурсам MCP:** изучите спецификации OpenAPI с помощью интуитивно понятных URI ( `openapi://info` , `openapi://paths/...` , `openapi://components/...` ).\n* **Поддержка OpenAPI v3.0 и Swagger v2.0:** загружает оба формата, автоматически конвертируя v2.0 в v3.0.\n* **Локальные и удаленные файлы:** загрузка спецификаций из локальных путей к файлам или URL-адресов HTTP/HTTPS.\n* **Эффективность токенов:** разработан для минимизации использования токенов для LLM за счет предоставления структурированного доступа.\n* **Несколько форматов вывода:** получайте подробные представления в формате JSON (по умолчанию), YAML или минифицированном JSON ( `--output-format` ).\n* **Динамическое имя сервера:** имя сервера в клиентах MCP отражает `info.title` из загруженной спецификации.\n* **Преобразование ссылок:** внутренние `$ref` ( `#/components/...` ) преобразуются в кликабельные URI MCP.\n\n## Доступные ресурсы MCP\n\nЭтот сервер предоставляет следующие шаблоны ресурсов MCP для изучения спецификации OpenAPI.\n\n**Понимание многозначных параметров ( `*` )**\n\nНекоторые шаблоны ресурсов включают параметры, заканчивающиеся звездочкой ( `*` ), например `{method*}` или `{name*}` . Это указывает на то, что параметр принимает **несколько значений, разделенных запятыми** . Например, чтобы запросить сведения для методов `GET` и `POST` пути, вы должны использовать URI типа `openapi://paths/users/get,post` . Это позволяет извлекать сведения для нескольких элементов в одном запросе.\n\n**Шаблоны ресурсов:**\n\n* **`openapi://{field}`**\n\n * **Описание:** Доступ к полям верхнего уровня документа OpenAPI (например, `info` , `servers` , `tags` ) или выводит список содержимого `paths` или `components` . Конкретные доступные поля зависят от загруженной спецификации.\n * **Пример:** `openapi://info`\n * **Вывод:** `text/plain` список для `paths` и `components` ; настроенный формат (JSON/YAML/минифицированный JSON) для других полей.\n * **Дополнения:** Предоставляет динамические предложения для `{field}` на основе фактических ключей верхнего уровня, найденных в загруженной спецификации.\n\n* **`openapi://paths/{path}`**\n\n * **Описание:** Перечисляет доступные методы HTTP (операции) для определенного пути API.\n * **Параметр:** `{path}` — строка пути API. **Должна быть закодирована в URL** (например, `/users/{id}` становится `users%2F%7Bid%7D` ).\n * **Пример:** `openapi://paths/users%2F%7Bid%7D`\n * **Вывод:** `text/plain` список методов.\n * **Дополнения:** Предоставляет динамические предложения для `{path}` на основе путей, найденных в загруженной спецификации (в кодировке URL).\n\n* **`openapi://paths/{path}/{method*}`**\n\n * **Описание:** Получает подробную спецификацию для одной или нескольких операций (методов HTTP) по определенному пути API.\n * **Параметры:**\n\n * `{path}` — строка пути API. **Должна быть закодирована в URL** .\n * `{method*}` — один или несколько методов HTTP (например, `get` , `post` , `get,post` ). Регистр не учитывается.\n * **Пример (одиночный):** `openapi://paths/users%2F%7Bid%7D/get`\n * **Пример (несколько):** `openapi://paths/users%2F%7Bid%7D/get,post`\n * **Вывод:** настроенный формат (JSON/YAML/минифицированный JSON).\n * **Дополнения:** Предоставляет динамические предложения для `{path}` . Предоставляет статические предложения для `{method*}` (общие HTTP-глаголы, такие как GET, POST, PUT, DELETE и т. д.).\n\n* **`openapi://components/{type}`**\n\n * **Описание:** Перечисляет имена всех определенных компонентов определенного типа (например, `schemas` , `responses` , `parameters` ). Конкретные доступные типы зависят от загруженной спецификации. Также предоставляет краткое описание для каждого перечисленного типа.\n * **Пример:** `openapi://components/schemas`\n * **Вывод:** `text/plain` список названий компонентов с описаниями.\n * **Дополнения:** Предоставляет динамические предложения для `{type}` на основе типов компонентов, найденных в загруженной спецификации.\n\n* **`openapi://components/{type}/{name*}`**\n\n * **Описание:** Получает подробную спецификацию для одного или нескольких именованных компонентов определенного типа.\n * **Параметры:**\n\n * `{type}` — Тип компонента.\n * `{name*}` — одно или несколько имен компонентов (например, `User` , `Order` , `User,Order` ). С учетом регистра.\n * **Пример (одиночный):** `openapi://components/schemas/User`\n * **Пример (несколько):** `openapi://components/schemas/User,Order`\n * **Вывод:** настроенный формат (JSON/YAML/минифицированный JSON).\n * **Дополнения:** Предоставляет динамические предложения для `{type}` . Предоставляет динамические предложения для `{name*}`*только если* загруженная спецификация содержит ровно один тип компонента в целом (например, только `schemas` ). Это ограничение существует, поскольку в настоящее время MCP SDK не поддерживает предоставление дополнений, ограниченных выбранным `{type}` ; предоставление всех имен по всем типам может ввести в заблуждение.\n\n## Внося вклад\n\nВклады приветствуются! Пожалуйста, ознакомьтесь с файлом [CONTRIBUTING.md](CONTRIBUTING.md) для получения инструкций по настройке среды разработки, запуску тестов и отправке изменений.\n\n## Релизы\n\nВ этом проекте используется [`semantic-release`](https://github.com/semantic-release/semantic-release) для автоматизированного управления версиями и публикации пакетов на основе [Conventional Commits](https://www.conventionalcommits.org/) .\n\n## Планы на будущее\n\n(Будущие планы будут определены)","Russian","ru-RU",{"_27":73,"_31":77,"_36":78},{"_29":74,"_31":75,"_33":76},"MCP 服务器通过 MCP 资源提供对 OpenAPI/Swagger 规范的令牌高效访问，以供客户端探索。","OpenAPI 架构资源管理器","# MCP OpenAPI 模式资源管理器\n\n[![npm 版本](https://badge.fury.io/js/mcp-openapi-schema-explorer.svg)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![NPM 下载](https://img.shields.io/npm/dw/mcp-openapi-schema-explorer)](https://badge.fury.io/js/mcp-openapi-schema-explorer) [![Docker拉取](https://img.shields.io/docker/pulls/kadykov/mcp-openapi-schema-explorer.svg)](https://hub.docker.com/r/kadykov/mcp-openapi-schema-explorer) [![许可证：MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![代码验证](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer/graph/badge.svg?token=LFDOMJ6W4W)](https://codecov.io/gh/kadykov/mcp-openapi-schema-explorer) [![在 MseeP 上验证](https://mseep.ai/badge.svg)](https://mseep.ai/app/819a3ba3-ad54-4657-9241-648497e57d7b)\n\nMCP（模型上下文协议）服务器，通过**MCP 资源**提供对 OpenAPI（v3.0）和 Swagger（v2.0）规范的令牌高效访问。\n\n## 项目目标\n\n该项目的主要目标是允许 MCP 客户端（例如 Cline 或 Claude Desktop）探索大型 OpenAPI 规范的结构和细节，而无需将整个文件加载到 LLM 的上下文窗口中。它通过 MCP 资源公开规范的各个部分来实现这一点，这些资源非常适合只读数据探索。\n\n此服务器支持从本地文件路径和远程 HTTP/HTTPS URL 加载规范。Swagger v2.0 规范在加载时会自动转换为 OpenAPI v3.0。\n\n## 为什么选择 MCP 资源？\n\n模型上下文协议定义了**资源**和**工具**。\n\n* \\*\\*资源：\\*\\*表示数据源（例如文件、API 响应）。它们非常适合 MCP 客户端进行只读访问和探索（例如，在 Claude Desktop 中浏览 API 路径）。\n* \\*\\*工具：\\*\\*表示可执行的操作或功能，通常由 LLM 用来执行任务或与外部系统交互。\n\n虽然其他 MCP 服务器可以通过*工具*访问 OpenAPI 规范，但本项目专注于通过*资源*提供访问。这使得它对于在 MCP 客户端应用程序中直接探索特别有用。\n\n有关 MCP 客户端及其功能的更多详细信息，请参阅[MCP 客户端文档](https://modelcontextprotocol.io/clients)。\n\n## 安装\n\n对于推荐的使用方法（ `npx`和 Docker，如下所述），**无需单独的安装步骤**。您的 MCP 客户端将根据您提供的配置自动下载软件包或拉取 Docker 镜像。\n\n但是，如果您更喜欢或需要明确安装服务器，则有两个选择：\n\n1. \\*\\*全局安装：\\*\\*您可以使用 npm 全局安装该包：\n\n ```bash\n npm install -g mcp-openapi-schema-explorer\n ```\n\n 请参阅下面的\\*\\*方法 3，\\*\\*了解如何配置 MCP 客户端以使用全局安装的服务器。\n\n2. \\*\\*本地开发/安装：\\*\\*您可以克隆存储库并在本地构建它：\n\n ```bash\n git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git\n cd mcp-openapi-schema-explorer\n npm install\n npm run build\n ```\n\n 请参阅下面的\\*\\*方法 4，\\*\\*了解如何配置 MCP 客户端以使用`node`从本地构建运行服务器。\n\n## 将服务器添加到您的 MCP 客户端\n\n此服务器设计为由 MCP 客户端（例如 Claude Desktop、Windsurf、Cline 等）运行。要使用它，您需要在客户端的设置文件（通常是 JSON 文件）中添加一个配置条目。此条目告诉客户端如何执行服务器进程（例如，使用`npx` 、 `docker`或`node` ）。除了客户端设置条目中指定的命令行参数外，服务器本身不需要单独的配置。\n\n以下是将服务器条目添加到客户端配置的常用方法。\n\n### 方法 1：npx（推荐）\n\n建议使用`npx` ，因为它可以避免全局/本地安装并确保客户端使用最新发布的版本。\n\n**客户端配置条目示例（npx 方法）：**\n\n将以下 JSON 对象添加到 MCP 客户端配置文件的`mcpServers`部分。此条目指示客户端如何使用`npx`运行服务器：\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (npx)\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"mcp-openapi-schema-explorer@latest\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n}\n```\n\n**配置说明：**\n\n* 将`\"My API Spec (npx)\"`替换为客户端中此服务器实例的唯一名称。\n* 将``替换为您指定的绝对本地文件路径或完整远程 URL。\n* `--output-format`是可选的（ `json` ， `yaml` ， `json-minified` ），默认为`json` 。\n* 要探索多个规范，请在`mcpServers`中添加单独的条目，每个条目都有唯一的名称并指向不同的规范。\n\n### 方法二：Docker\n\n您可以指示您的 MCP 客户端使用官方 Docker 镜像运行服务器： `kadykov/mcp-openapi-schema-explorer` 。\n\n**客户端配置条目示例（Docker 方法）：**\n\n将以下 JSON 对象之一添加到 MCP 客户端配置文件的`mcpServers`部分。这些条目指示客户端如何使用`docker run`运行服务器：\n\n* \\*\\*远程 URL：\\*\\*将 URL 直接传递给`docker run` 。\n\n* **使用远程 URL：**\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Remote)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n* \\*\\*使用本地文件：（\\*\\*需要将文件挂载到容器中）\n\n ```json\n {\n \"mcpServers\": {\n \"My API Spec (Docker Local)\": {\n \"command\": \"docker\",\n \"args\": [\n \"run\",\n \"--rm\",\n \"-i\",\n \"-v\",\n \"/full/host/path/to/spec.yaml:/spec/api.yaml\",\n \"kadykov/mcp-openapi-schema-explorer:latest\",\n \"/spec/api.yaml\",\n \"--output-format\",\n \"yaml\"\n ],\n \"env\": {}\n }\n }\n }\n ```\n\n \\*\\*重要提示：\\*\\*请将`/full/host/path/to/spec.yaml`替换为主机上正确的绝对路径。路径`/spec/api.yaml`是容器内的对应路径。\n\n### 方法 3：全局安装（不太常见）\n\n如果您已经使用`npm install -g`全局安装了��包，则可以配置您的客户端以直接运行它。\n\n```bash\n# Run this command once in your terminal\nnpm install -g mcp-openapi-schema-explorer\n```\n\n**客户端配置条目示例（全局安装方法）：**\n\n将以下条目添加到 MCP 客户端的配置文件中。此操作假设`mcp-openapi-schema-explorer`命令可在客户端的执行环境变量 PATH 中访问。\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Global)\": {\n \"command\": \"mcp-openapi-schema-explorer\",\n \"args\": [\"\", \"--output-format\", \"yaml\"],\n \"env\": {}\n }\n }\n}\n```\n\n* 确保`command` （ `mcp-openapi-schema-explorer` ）可在 MCP 客户端使用的 PATH 环境变量中访问。\n\n### 方法四：本地开发/安装\n\n如果您已在本地克隆存储库以进行开发或运行修改后的版本，则此方法很有用。\n\n**设置步骤（在终端运行一次）：**\n\n1. 克隆存储库： `git clone https://github.com/kadykov/mcp-openapi-schema-explorer.git`\n2. 导航到目录： `cd mcp-openapi-schema-explorer`\n3. 安装依赖项： `npm install`\n4. 构建项目： `npm run build` （或者`just build` ）\n\n**客户端配置条目示例（本地开发方法）：**\n\n将以下条目添加到 MCP 客户端的配置文件中。这将指示客户端使用`node`运行本地构建的服务器。\n\n```json\n{\n \"mcpServers\": {\n \"My API Spec (Local Dev)\": {\n \"command\": \"node\",\n \"args\": [\n \"/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js\",\n \"\",\n \"--output-format\",\n \"yaml\"\n ],\n\n \"env\": {}\n }\n }\n}\n```\n\n\\*\\*重要提示：\\*\\*将`/full/path/to/cloned/mcp-openapi-schema-explorer/dist/src/index.js`替换为克隆存储库中构建的`index.js`文件的正确绝对路径。\n\n## 特征\n\n* \\*\\*MCP 资源访问：\\*\\*通过直观的 URI（ `openapi://info` 、 `openapi://paths/...``openapi://components/...` ）探索 OpenAPI 规范。\n* \\*\\*OpenAPI v3.0 和 Swagger v2.0 支持：\\*\\*加载两种格式，自动将 v2.0 转换为 v3.0。\n* \\*\\*本地和远程文件：\\*\\*从本地文件路径或 HTTP/HTTPS URL 加载规范。\n* \\*\\*令牌高效：\\*\\*旨在通过提供结构化访问来最大限度地减少 LLM 的令牌使用。\n* \\*\\*多种输出格式：\\*\\*以 JSON（默认）、YAML 或最小化 JSON（ `--output-format` ）获取详细视图。\n* **动态服务器名称：** MCP 客户端中的服务器名称反映了已加载规范的`info.title` 。\n* \\*\\*引用转换：\\*\\*内部`$ref` ( `#/components/...` ) 转换为可点击的 MCP URI。\n\n## 可用的 MCP 资源\n\n该服务器公开以下 MCP 资源模板，用于探索 OpenAPI 规范。\n\n**了解多值参数 ( `*` )**\n\n一些资源模板包含以星号 ( `*` ) 结尾的参数，例如`{method*}`或`{name*}` 。这表示该参数接受**多个逗号分隔的值**。例如，要请求路径的`GET`和`POST`方法的详细信息，可以使用类似`openapi://paths/users/get,post` URI。这样可以在单个请求中获取多个项目的详细信息。\n\n**资源模板：**\n\n* **`openapi://{field}`**\n\n * \\*\\*描述：\\*\\*访问 OpenAPI 文档的顶级字段（例如， `info` 、 `servers` 、 `tags` ），或列出`paths`或`components`的内容。具体可用字段取决于加载的规范。\n * **例如：** `openapi://info`\n * **输出：** `paths`和`components`的`text/plain`列表；其他字段的配置格式（JSON/YAML/最小化 JSON）。\n * \\*\\*完成：\\*\\*根据加载的规范中找到的实际顶级键为`{field}`提供动态建议。\n\n* **`openapi://paths/{path}`**\n\n * \\*\\*描述：\\*\\*列出特定 API 路径可用的 HTTP 方法（操作）。\n * **参数：** `{path}` - API 路径字符串。**必须进行 URL 编码**（例如， `/users/{id}`变为`users%2F%7Bid%7D` ）。\n * **例如：** `openapi://paths/users%2F%7Bid%7D`\n * **输出：** `text/plain`方法列表。\n * \\*\\*完成：\\*\\*根据加载的规范（URL 编码）中找到的路径，为`{path}`提供动态建议。\n\n* **`openapi://paths/{path}/{method*}`**\n\n * \\*\\*描述：\\*\\*获取特定 API 路径上的一个或多个操作（HTTP 方法）的详细规范。\n * **参数：**\n\n * `{path}` - API 路径字符串。**必须经过 URL 编码**。\n * `{method*}` - 一个或多个 HTTP 方法 (例如`get` 、 `post` 、 `get,post` )。不区分大小写。\n * **示例（单个）：** `openapi://paths/users%2F%7Bid%7D/get`\n * **示例（多个）：** `openapi://paths/users%2F%7Bid%7D/get,post`\n * \\*\\*输出：\\*\\*配置格式（JSON/YAML/最小化 JSON）。\n * \\*\\*补全：\\*\\*为`{path}`提供动态建议。为`{method*}`提供静态建议（常见的 HTTP 动词，如 GET、POST、PUT、DELETE 等）。\n\n* **`openapi://components/{type}`**\n\n * \\*\\*描述：\\*\\*列出特定类型（例如， `schemas` 、 `responses` 、 `parameters` ）的所有已定义组件的名称。具体可用的类型取决于加载的规范。此外，还提供了每种列出类型的简短描述。\n * **例如：** `openapi://components/schemas`\n * \\*\\*输出：\\*\\*带有描述的组件名称的`text/plain`列表。\n * \\*\\*完成：\\*\\*根据在加载的规范中找到的组件类型为`{type}`提供动态建议。\n\n* **`openapi://components/{type}/{name*}`**\n\n * \\*\\*描述：\\*\\*获取特定类型的一个或多个命名组件的详细规范。\n * **参数：**\n\n * `{type}` - 组件类型。\n * `{name*}` - 一个或多个组件名称（例如， `User` 、 `Order` 、 `User,Order` ）。区分大小写。\n * **示例（单个）：** `openapi://components/schemas/User`\n * **示例（多个）：** `openapi://components/schemas/User,Order`\n * \\*\\*输出：\\*\\*配置格式（JSON/YAML/最小化 JSON）。\n * \\*\\*补全：\\*\\*提供针对`{type}`的动态建议。*仅当*加载的规范整体上只包含一种组件类型（例如，仅包含`schemas` ）时，才会提供针对`{name*}`的动态建议。存在此限制是因为 MCP SDK 目前不支持提供针对所选`{type}`范围的补全；提供所有类型的所有名称可能会产生误导。\n\n## 贡献\n\n欢迎贡献代码！请参阅[CONTRIBUTING.md](CONTRIBUTING.md)文件，了解如何设置开发环境、运行测试以及提交更改。\n\n## 发布\n\n该项目使用[`semantic-release`](https://github.com/semantic-release/semantic-release)进行基于[Conventional Commits 的](https://www.conventionalcommits.org/)自动化版本管理和包发布。\n\n## 未来计划\n\n（未来计划待定）","Chinese","zh-CN","githubUser","locale",{"_82":83,"_13":84,"_92":40,"_93":40,"_16":94,"_95":96,"_31":32,"_141":142,"_149":-5,"_150":-5,"_151":152,"_188":189,"_194":-5,"_103":170,"_195":174,"_106":196,"_197":198},"addedAt","2025-04-14T10:53:35.949058Z",[85,86,87,88,89,90,91,86],"category:developer-tools","author:claimed","hosting:hybrid","language:typescript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","descriptionPlainText",5441,"integrations",[97,108,115,121,127,134],{"_98":99,"_29":105,"_106":107},"brand",{"_100":101,"_31":102,"_103":104},"logoSvgPath","M12.006.481C5.391.486.005 5.831 0 12.399v.03l2.042 1.19.028-.018a5.82 5.82 0 013.308-1.02c.37 0 .733.034 1.085.1l-.036-.006a5.69 5.69 0 012.874 1.43l-.004-.002.35.326.198-.434c.192-.42.414-.814.66-1.173.1-.144.208-.29.332-.446l.205-.257-.252-.211a8.33 8.33 0 00-3.836-1.807l-.052-.008a8.565 8.565 0 00-4.08.251l.06-.016c.972-4.256 4.714-7.223 9.133-7.226a9.31 9.31 0 016.6 2.713 9.196 9.196 0 012.508 4.498 8.385 8.385 0 00-2.498-.379h-.154c-.356.006-.7.033-1.036.078l.045-.005-.042.006a8.103 8.103 0 00-.39.06c-.057.01-.114.022-.17.033a8.102 8.102 0 00-.392.09l-.138.034a9.21 9.21 0 00-.483.144l-.03.01c-.354.12-.708.268-1.05.44l-.027.013c-.152.076-.305.16-.47.256l-.035.022a8.216 8.216 0 00-2.108 1.8l-.011.014-.075.092a8.345 8.345 0 00-.378.503c-.088.13-.177.269-.288.452l-.06.104a8.985 8.985 0 00-.234.432l-.016.029c-.17.34-.317.698-.44 1.063l-.017.053a8.052 8.052 0 00-.41 2.716v-.007.112a12 12 0 00.023.431l-.002-.037a11.676 11.676 0 00.042.412l.005.042.013.103c.018.127.038.252.062.378.241 1.266.845 2.532 1.745 3.66l.041.051.042-.05c.359-.424 1.249-1.77 1.325-2.577v-.015l-.006-.013a5.56 5.56 0 01-.64-2.595c0-3.016 2.37-5.521 5.396-5.702l.2-.007a5.93 5.93 0 013.47 1.025l.027.019L24 12.416v-.03a11.77 11.77 0 00-3.51-8.423A11.962 11.962 0 0012.007.48z","Codecov","slug","codecov","Reports code coverage metrics to Codecov for project quality assurance","uid","mr5il4rvd0",{"_98":109,"_29":113,"_106":114},{"_100":110,"_31":111,"_103":112},"M13.983 11.078h2.119a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.119a.185.185 0 00-.185.185v1.888c0 .102.083.185.185.185m-2.954-5.43h2.118a.186.186 0 00.186-.186V3.574a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m0 2.716h2.118a.187.187 0 00.186-.186V6.29a.186.186 0 00-.186-.185h-2.118a.185.185 0 00-.185.185v1.887c0 .102.082.185.185.186m-2.93 0h2.12a.186.186 0 00.184-.186V6.29a.185.185 0 00-.185-.185H8.1a.185.185 0 00-.185.185v1.887c0 .102.083.185.185.186m-2.964 0h2.119a.186.186 0 00.185-.186V6.29a.185.185 0 00-.185-.185H5.136a.186.186 0 00-.186.185v1.887c0 .102.084.185.186.186m5.893 2.715h2.118a.186.186 0 00.186-.185V9.006a.186.186 0 00-.186-.186h-2.118a.185.185 0 00-.185.185v1.888c0 .102.082.185.185.185m-2.93 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.083.185.185.185m-2.964 0h2.119a.185.185 0 00.185-.185V9.006a.185.185 0 00-.184-.186h-2.12a.186.186 0 00-.186.186v1.887c0 .102.084.185.186.185m-2.92 0h2.12a.185.185 0 00.184-.185V9.006a.185.185 0 00-.184-.186h-2.12a.185.185 0 00-.184.185v1.888c0 .102.082.185.185.185M23.763 9.89c-.065-.051-.672-.51-1.954-.51-.338.001-.676.03-1.01.087-.248-1.7-1.653-2.53-1.716-2.566l-.344-.199-.226.327c-.284.438-.49.922-.612 1.43-.23.97-.09 1.882.403 2.661-.595.332-1.55.413-1.744.42H.751a.751.751 0 00-.75.748 11.376 11.376 0 00.692 4.062c.545 1.428 1.355 2.48 2.41 3.124 1.18.723 3.1 1.137 5.275 1.137.983.003 1.963-.086 2.93-.266a12.248 12.248 0 003.823-1.389c.98-.567 1.86-1.288 2.61-2.136 1.252-1.418 1.998-2.997 2.553-4.4h.221c1.372 0 2.215-.549 2.68-1.009.309-.293.55-.65.707-1.046l.098-.288Z","Docker","docker","Provides official Docker images for containerized deployment of the MCP server","cxy55dfmcy",{"_98":116,"_29":119,"_106":120},{"_100":117,"_31":118,"_103":118},"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","npm","Distributed through npm registry, allowing installation and execution via npx or global installation","06o9dpfctc",{"_98":122,"_29":125,"_106":126},{"_100":123,"_31":124,"_103":124},"M11.952 14.4a2.4 2.4 0 1 1 0-4.8 2.4 2.4 0 0 1 0 4.8zm0-.72a1.68 1.68 0 1 0 0-3.36 1.68 1.68 0 0 0 0 3.36zM8.304 3.12v1.728c.096.528 1.008 2.64 1.68 3.888C9.12 8.112 7.2 6.672 6.672 5.952a4.416 4.416 0 0 1-.816-1.392L2.448 6.48v4.128c.432.24 1.104.72 1.488.864.528.192 2.832.432 4.224.48-1.008.432-3.168 1.392-4.08 1.488-.768.144-1.296.048-1.632 0v4.08l3.312 1.872c.432-.192 1.152-.576 1.488-.816.432-.336 1.776-2.208 2.496-3.408-.096 1.056-.384 3.408-.72 4.272-.288.72-.624 1.104-.816 1.392L12 22.992l3.504-2.016c.048-.432.096-1.344 0-1.824-.048-.528-1.008-2.64-1.632-3.888.864.672 2.736 2.112 3.312 2.832.528.624.72 1.152.816 1.44l3.552-2.016v-4.032c-.384-.24-1.152-.72-1.632-.912-.48-.192-2.784-.432-4.176-.48 1.008-.48 3.168-1.392 4.08-1.488.864-.144 1.392-.048 1.728.048V6.48l-3.36-1.92-1.488.912c-.432.336-1.776 2.208-2.544 3.36.144-1.056.432-3.408.768-4.272.288-.72.624-1.152.864-1.392L12 1.008zM12 0l10.416 6v12L12 24 1.584 18V6z","semantic-release","Uses semantic-release for automated version management and package publishing","0pqsnzfiqn",{"_98":128,"_29":132,"_106":133},{"_100":129,"_31":130,"_103":131},"M12 0C5.383 0 0 5.383 0 12s5.383 12 12 12c6.616 0 12-5.383 12-12S18.616 0 12 0zm0 1.144c5.995 0 10.856 4.86 10.856 10.856 0 5.995-4.86 10.856-10.856 10.856-5.996 0-10.856-4.86-10.856-10.856C1.144 6.004 6.004 1.144 12 1.144zM8.37 5.868a6.707 6.707 0 0 0-.423.005c-.983.056-1.573.517-1.735 1.472-.115.665-.096 1.348-.143 2.017-.013.35-.05.697-.115 1.038-.134.609-.397.798-1.016.83a2.65 2.65 0 0 0-.244.042v1.463c1.126.055 1.278.452 1.37 1.629.033.429-.013.858.015 1.287.018.406.073.808.156 1.2.259 1.075 1.307 1.435 2.575 1.218v-1.283c-.203 0-.383.005-.558 0-.43-.013-.591-.12-.632-.535-.056-.535-.042-1.08-.075-1.62-.064-1.001-.175-1.988-1.153-2.625.503-.37.868-.812.983-1.398.083-.41.134-.821.166-1.237.028-.415-.023-.84.014-1.25.06-.665.102-.937.9-.91.12 0 .235-.017.369-.027v-1.31c-.16 0-.31-.004-.454-.006zm7.593.009a4.247 4.247 0 0 0-.813.06v1.274c.245 0 .434 0 .623.005.328.004.577.13.61.494.032.332.031.669.064 1.006.065.669.101 1.347.217 2.007.102.544.475.95.941 1.283-.817.549-1.057 1.333-1.098 2.215-.023.604-.037 1.213-.069 1.822-.028.554-.222.734-.78.748-.157.004-.31.018-.484.028v1.305c.327 0 .627.019.927 0 .932-.055 1.495-.507 1.68-1.412.078-.498.124-1 .138-1.504.032-.461.028-.927.074-1.384.069-.715.397-1.01 1.112-1.057a.972.972 0 0 0 .199-.046v-1.463c-.12-.014-.204-.027-.291-.032-.536-.023-.804-.203-.937-.71a5.146 5.146 0 0 1-.152-.993c-.037-.618-.033-1.241-.074-1.86-.08-1.192-.794-1.753-1.887-1.786zm-6.89 5.28a.844.844 0 0 0-.083 1.684h.055a.83.83 0 0 0 .877-.78v-.046a.845.845 0 0 0-.83-.858zm2.911 0a.808.808 0 0 0-.834.78c0 .027 0 .05.004.078 0 .503.342.826.859.826.507 0 .826-.332.826-.853-.005-.503-.342-.836-.855-.831zm2.963 0a.861.861 0 0 0-.876.835c0 .47.378.849.849.849h.009c.425.074.853-.337.881-.83.023-.457-.392-.854-.863-.854z","Swagger","swagger","Provides token-efficient access to Swagger v2.0 specifications, automatically converting them to OpenAPI v3.0 for structured exploration","5dt1254c18",{"_98":135,"_29":139,"_106":140},{"_100":136,"_31":137,"_103":138},"m0 .97 4.111 6.453v4.09h2.638v-4.09L11.053.969H8.214L5.58 5.125 2.965.969Zm12.093.024-4.47 10.544h2.114l.97-2.345h4.775l.804 2.345h2.26L14.255.994Zm1.133 2.225 1.463 3.87h-3.096zm3.06 9.475v10.29H24v-2.199h-5.454v-8.091zm-12.175.002v10.335h2.217v-7.129l2.32 4.792h1.746l2.4-4.96v7.295h2.127V12.696h-2.904L9.44 17.37l-2.455-4.674Z","YAML","yaml","Supports YAML as an output format for viewing OpenAPI specifications","kad1dlyyif","namespace",{"_143":144,"_103":148},"owner",{"_145":146},"githubAccount",{"_147":148},"login","kadykov","readmeMarkdown","redditPostExternalId","repository",{"_153":-5,"_154":155,"_159":160,"_180":-5,"_181":182,"_183":184,"_187":-5},"argumentsJsonSchema","githubProject",{"_33":156,"_157":158},"

\n $\"MCP$ \n

MCP directory API