mcp-graphql
Ein Model Context Protocol-Server, der LLMs die Interaktion mit GraphQL-APIs ermöglicht. Diese Implementierung bietet Funktionen zur Schema-Introspektion und Abfrageausführung, sodass Modelle GraphQL-APIs dynamisch erkennen und nutzen können.
Verwendung
Führen Sie mcp-graphql mit dem richtigen Endpunkt aus. Es wird automatisch versucht, Ihre Abfragen zu überprüfen.
Umgebungsvariablen (wichtige Änderung in 1.0.0)
Hinweis: Ab Version 1.0.0 wurden Befehlszeilenargumente durch Umgebungsvariablen ersetzt.
Umgebungsvariable | Beschreibung | Standard |
| GraphQL-Endpunkt-URL |
|
| JSON-String mit Headern für Anfragen |
|
| Mutationsvorgänge aktivieren (standardmäßig deaktiviert) |
|
| Name des MCP-Servers |
|
| Pfad zu einer lokalen GraphQL-Schemadatei (optional) | - |
Beispiele
Related MCP server: mcp-graphql-schema
Ressourcen
graphql-schema : Der Server stellt das GraphQL-Schema als Ressource bereit, auf die Clients zugreifen können. Dies ist entweder die lokale Schemadatei oder basiert auf einer Introspektionsabfrage.
Verfügbare Tools
Der Server bietet zwei Haupttools:
introspect-schema : Dieses Tool ruft das GraphQL-Schema ab. Verwenden Sie es zuerst, wenn Sie keinen Zugriff auf das Schema als Ressource haben. Es verwendet entweder die lokale Schemadatei oder eine Introspektionsabfrage.
query-graphql : Führt GraphQL-Abfragen für den Endpunkt aus. Standardmäßig sind Mutationen deaktiviert, es sei denn,
ALLOW_MUTATIONSist auftruegesetzt.
Installation
Installation über Smithery
So installieren Sie GraphQL MCP Server für Claude Desktop automatisch über Smithery :
Manuelle Installation
Es kann manuell auf Claude installiert werden:
Sicherheitsüberlegungen
Mutationen sind standardmäßig aus Sicherheitsgründen deaktiviert, um zu verhindern, dass ein LLM Ihre Datenbank- oder Servicedaten ändert. Überlegen Sie gut, bevor Sie Mutationen in Produktionsumgebungen aktivieren.
Anpassen für Ihren eigenen Server
Dies ist eine sehr generische Implementierung, die vollständige Selbstbeobachtung ermöglicht und Ihren Benutzern freie Hand lässt (einschließlich Mutationen). Wenn Sie eine spezifischere Implementierung benötigen, empfehle ich Ihnen, einfach ein eigenes MCP zu erstellen und ein Tool zu sperren, das Clients nur die Eingabe bestimmter Abfragefelder und/oder Variablen erlaubt. Sie können dies als Referenz verwenden.