Skip to main content
Glama

Unbundle OpenAPI Specs MCP

by auto-browse

OpenAPI MCP-Server entbündeln

Dieses Projekt bietet einen Model Context Protocol (MCP)-Server mit Tools zum Aufteilen von OpenAPI-Spezifikationsdateien in mehrere Dateien oder zum Extrahieren bestimmter Endpunkte in eine neue Datei. Es ermöglicht einem MCP-Client (z. B. einem KI-Assistenten), OpenAPI-Spezifikationen programmgesteuert zu bearbeiten.

Voraussetzungen

  • Node.js (LTS-Version empfohlen, z. B. v18 oder v20)
  • npm (wird mit Node.js geliefert)

Verwendung

Installation über Smithery

So installieren Sie Unbundle OpenAPI MCP Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @auto-browse/unbundle_openapi_mcp --client claude

Am einfachsten nutzen Sie diesen Server über npx . Dadurch wird sichergestellt, dass Sie immer die neueste Version verwenden, ohne dass eine globale Installation erforderlich ist.

npx @auto-browse/unbundle-openapi-mcp@latest

Alternativ können Sie es global installieren (nicht generell empfohlen):

npm install -g @auto-browse/unbundle-openapi-mcp # Then run using: unbundle-openapi-mcp

Der Server wird gestartet und wartet auf MCP-Anfragen auf der Standardeingabe/-ausgabe (stdio).

Client-Konfiguration

Um diesen Server mit MCP-Clients wie VS Code, Cline, Cursor oder Claude Desktop zu verwenden, fügen Sie seine Konfiguration der entsprechenden Einstellungsdatei hinzu. Der empfohlene Ansatz verwendet npx .

VS Code / Cline / Cursor

Fügen Sie Folgendes zu Ihrer Datei „User settings.json (zugänglich über Ctrl+Shift+P > Preferences: Open User Settings (JSON) ) oder zu einer Datei .vscode/mcp.json in Ihrem Arbeitsbereichsstamm hinzu.

// In settings.json: "mcp.servers": { "unbundle_openapi": { // You can choose any key name "command": "npx", "args": [ "@auto-browse/unbundle-openapi-mcp@latest" ] } // ... other servers can be added here }, // Or in .vscode/mcp.json (omit the top-level "mcp.servers"): { "unbundle_openapi": { // You can choose any key name "command": "npx", "args": [ "@auto-browse/unbundle-openapi-mcp@latest" ] } // ... other servers can be added here }

Claude Desktop

Fügen Sie Ihrer Datei claude_desktop_config.json Folgendes hinzu.

{ "mcpServers": { "unbundle_openapi": { // You can choose any key name "command": "npx", "args": ["@auto-browse/unbundle-openapi-mcp@latest"] } // ... other servers can be added here } }

Starten Sie Ihre Clientanwendung nach dem Hinzufügen der Konfiguration neu, damit die Änderungen wirksam werden.

Bereitgestellte MCP-Tools

split_openapi

Beschreibung: Führt den Befehl redocly split aus, um eine OpenAPI-Definitionsdatei basierend auf ihrer Struktur in mehrere kleinere Dateien aufzuteilen.

Argumente:

  • apiPath (Zeichenfolge, erforderlich): Der absolute Pfad zur OpenAPI-Eingabedefinitionsdatei (z. B. openapi.yaml ).
  • outputDir (Zeichenfolge, erforderlich): Der absolute Pfad zum Verzeichnis, in dem die geteilten Ausgabedateien gespeichert werden sollen. Dieses Verzeichnis wird erstellt, falls es nicht existiert.

Widerrufsfolgen:

  • Bei Erfolg: Eine Textnachricht mit der Standardausgabe des redocly split Befehls (normalerweise eine Bestätigungsnachricht).
  • Bei einem Fehler: Eine Fehlermeldung mit den Standardfehler- oder Ausnahmedetails der Befehlsausführung, gekennzeichnet mit isError: true .

Beispielverwendung (konzeptionelle MCP-Anforderung):

{ "tool_name": "split_openapi", "arguments": { "apiPath": "/path/to/your/openapi.yaml", "outputDir": "/path/to/output/directory" } }

extract_openapi_endpoints

Beschreibung: Extrahiert bestimmte Endpunkte aus einer großen OpenAPI-Definitionsdatei und erstellt eine neue, kleinere OpenAPI-Datei, die nur diese Endpunkte und die referenzierten Komponenten enthält. Dies wird erreicht, indem die Originaldatei aufgeteilt, die Struktur so geändert wird, dass nur angegebene Pfade enthalten sind, und das Ergebnis anschließend gebündelt wird.

Argumente:

  • inputApiPath (Zeichenfolge, erforderlich): Der absolute Pfad zur großen OpenAPI-Eingabedefinitionsdatei.
  • endpointsToKeep (Array von Zeichenfolgen, erforderlich): Eine Liste der genauen Endpunktpfade (Zeichenfolgen), die in die endgültige Ausgabe aufgenommen werden sollen (z. B. ["/api", "/api/projects/{id}{.format}"] ). Pfade, die nicht in der ursprünglichen Spezifikation gefunden wurden, werden ignoriert.
  • outputApiPath (Zeichenfolge, erforderlich): Der absolute Pfad, in dem die endgültige, kleinere gebündelte OpenAPI-Datei gespeichert werden soll. Das Verzeichnis wird erstellt, falls es nicht existiert.

Widerrufsfolgen:

  • Bei Erfolg: Eine Textnachricht mit dem Pfad der erstellten Datei und der Standardausgabe des redocly bundle -Befehls.
  • Bei einem Fehler: Eine Fehlermeldung mit Details zum fehlgeschlagenen Schritt (Teilen, Ändern, Bündeln), gekennzeichnet mit isError: true .

Beispielverwendung (konzeptionelle MCP-Anforderung):

{ "tool_name": "extract_openapi_endpoints", "arguments": { "inputApiPath": "/path/to/large-openapi.yaml", "endpointsToKeep": ["/users", "/users/{userId}/profile"], "outputApiPath": "/path/to/extracted-openapi.yaml" } }

Hinweis: Dieser Server verwendet intern npx @redocly/cli@latest um die zugrunde liegenden split und bundle -Befehle auszuführen. Möglicherweise ist eine Internetverbindung erforderlich, damit npx @redocly/cli abrufen kann, falls es nicht zwischengespeichert ist. Temporäre Dateien werden während des extract_openapi_endpoints -Prozesses erstellt und automatisch bereinigt.

Entwicklung

Wenn Sie beitragen oder den Server aus der Quelle ausführen möchten:

  1. Klonen: Klonen Sie dieses Repository.
  2. Navigieren Sie: cd unbundle_openapi_mcp
  3. Abhängigkeiten installieren: npm install
  4. Build: npm run build (kompiliert TypeScript nach dist/ )
  5. Ausführen: npm start (startet den Server mit dem kompilierten Code in dist/ )
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

OpenAPI-Spezifikationen MCP entbündeln

  1. Voraussetzungen
    1. Verwendung
      1. Installation über Smithery
    2. Client-Konfiguration
      1. VS Code / Cline / Cursor
      2. Claude Desktop
    3. Bereitgestellte MCP-Tools
      1. split_openapi
      2. extract_openapi_endpoints
    4. Entwicklung

      Related MCP Servers

      • -
        security
        A
        license
        -
        quality
        OpsLevel MCP
        Last updated a day ago
        6
        Go
        MIT License
        • Apple
      • -
        security
        A
        license
        -
        quality
        api-test-mcp
        Last updated 2 days ago
        6
        JavaScript
        MIT License
        • Apple
        • Linux
      • A
        security
        F
        license
        A
        quality
        Anki MCP
        Last updated 22 days ago
        91
        9
        2
        TypeScript
        • Apple

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/auto-browse/unbundle_openapi_mcp'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server