Swagger-MCP

Überblick

swagger-mcp ist ein Tool zum Scrapen der Swagger-Benutzeroberfläche. Es extrahiert die Datei swagger.json und generiert zur Laufzeit dynamisch klar definierte MCP-Tools. Diese Tools können vom MCP-Client zur weiteren Toolauswahl verwendet werden.

Related MCP server: MCP Swagger Server

📽️ Demo-Video

Sehen Sie sich das Demo-Video an, das das Projekt in Aktion zeigt:

🙌 Unterstützung

Wenn Sie dieses Projekt wertvoll finden, unterstützen Sie mich bitte auf LinkedIn , indem Sie:

• 👍 Liken und Teilen unseres Demo-Beitrags

• 💬 Hinterlassen Sie Ihre Gedanken und Ihr Feedback in den Kommentaren

• 🔗 Verbinden Sie sich mit mir für zukünftige Updates

Ihre Unterstützung auf LinkedIn wird mir helfen, mehr Menschen zu erreichen und das Projekt zu verbessern!

Voraussetzungen

Um swagger-mcp zu verwenden, stellen Sie sicher, dass Sie über die folgenden Abhängigkeiten verfügen:

1. LLM-Modell-API-Schlüssel/Lokales LLM : Erfordert Zugriff auf OpenAI-, Claude- oder Ollama-Modelle.

2. Jeder MCP-Client : (Verwendet mark3labs - mcphost )

Installation und Einrichtung

Befolgen Sie diese Schritte, um swagger-mcp zu installieren und auszuführen:

go install github.com/danishjsheikh/swagger-mcp@latest
swagger-mcp

Ausführungskonfiguration

swagger-mcp direkt auszuführen, verwenden Sie:

swagger-mcp --specUrl=https://your_swagger_api_docs.json

Hauptflaggen:

• --specUrl : Swagger/OpenAPI JSON-URL (erforderlich)

• --sseMode : Im SSE-Modus ausführen (Standard: „false“, wenn „true“ als SSE-Server ausgeführt wird, andernfalls wird stdio verwendet)

• --sseAddr : Abhöradresse des SSE-Servers im Format IP:Port oder :Port (falls leer, wird IP:Port von --sseUrl verwendet)

• --sseUrl : Basis-URL des SSE-Servers (wenn leer, wird sseAddr zum Generieren verwendet, z. B. http://IP:Port oder http://localhost:Port )

• Wenn sowohl --sseAddr als auch --sseUrl festgelegt sind, werden sie unverändert und ohne automatische Komplementierung verwendet.

• --baseUrl : Basis-URL für API-Anfragen überschreiben

• --security : API-Sicherheitstyp ( basic , apiKey oder bearer )

• --basicAuth : Grundlegende Authentifizierung im Benutzer:Passwort-Format

• --bearerAuth : Bearer-Token für den Autorisierungsheader

• --apiKeyAuth : API-Schlüssel, Format passAs:name=value (z. B. header:token=abc,query:user=foo,cookie:sid=xxx )

• Alle unterstützten Flags und Optionen finden Sie in main.go.

MCP-Konfiguration

Zur Integration mit mcphost fügen Sie die folgende Konfiguration in .mcp.json ein:

{
    "mcpServers":
    {
        "swagger_loader": {
            "command": "swagger-mcp",
            "args": ["--specUrl=<swagger/doc.json_url>"]
        }
    }
}

Demo-Ablauf

1. Einige Backends:

   go install github.com/danishjsheikh/go-backend-demo@latest 
   go-backend-demo

2. Ollama

   ollama run llama3.2

3. MCP-Client

   go install github.com/mark3labs/mcphost@latest
   mcphost -m ollama:llama3.2 --config <.mcp.json_file_path>

Flussdiagramm

🛠️ Brauchen Sie Hilfe

Ich arbeite an der Verbesserung der Werkzeugdefinitionen, um Folgendes zu verbessern:
✅ Bessere Fehlerbehandlung für genauere Antworten
✅ LLM-Verhaltenskontrolle, um sicherzustellen, dass es nur auf API-Antworten angewiesen ist und keinen eigenen Speicher verwendet
✅ Verhinderung von Halluzinationen und zufälliger Datengenerierung durch die Durchsetzung eines strikten Datenabrufs von APIs

Wenn Sie Erkenntnisse oder Vorschläge zur Verbesserung dieser Aspekte haben, leisten Sie bitte einen Beitrag, indem Sie:

• Teilen Sie Ihre Erfahrungen mit ähnlichen Implementierungen

• Änderungsvorschläge für Werkzeugdefinitionen

• Bereitstellung von Feedback zu aktuellen Einschränkungen

Ihr Beitrag wird von unschätzbarem Wert sein, um dieses Tool zuverlässiger und effektiver zu machen! 🚀