AnythingMCP
Back to Guides

GraphQL-APIs in MCP-Server umwandeln

Verbinden Sie beliebige GraphQL-APIs mit dem Model Context Protocol. Lassen Sie KI-Agenten Daten über GraphQL-Endpunkte mit AnythingMCP abfragen und ändern.

GraphQL und MCP: Eine natürliche Kombination

Das typisierte Schema und die selbstdokumentierende Natur von GraphQL machen es zu einer idealen Quelle für die MCP-Tool-Generierung. AnythingMCP nutzt die GraphQL-Introspektion, um automatisch gut typisierte MCP-Tools aus Ihren Queries und Mutations zu erstellen.

Warum GraphQL zu MCP konvertieren?

Während GraphQL für Entwickler leistungsstark ist, benötigen KI-Agenten das MCP-Protokoll, um mit Tools zu interagieren. Durch die Konvertierung von GraphQL zu MCP ermöglichen Sie KI-Agenten:

  • Daten abfragen mit natürlicher Sprache anstatt GraphQL-Queries zu schreiben
  • Mutations ausführen sicher mit validierten Parametern
  • Beziehungen navigieren ohne Graph-Traversierung zu verstehen

Schritt-für-Schritt-Anleitung

Schritt 1: AnythingMCP bereitstellen

Klonen Sie das Repository und starten Sie die Anwendung mit Docker Compose:

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Dies startet PostgreSQL, die Backend-API (Port 4000) und das Dashboard (Port 3000).

Schritt 2: Einen GraphQL-Connector erstellen

Öffnen Sie das AnythingMCP-Dashboard unter http://localhost:3000 und erstellen Sie einen neuen GraphQL-Connector. Geben Sie die GraphQL-Endpunkt-URL an — AnythingMCP verwendet die Introspektion, um automatisch das vollständige Schema einschließlich aller Queries, Mutations und Typen zu erkennen.

Schritt 3: Schema-Introspektion

AnythingMCP führt automatisch eine Introspektion Ihres GraphQL-Schemas durch und generiert MCP-Tools:

  • Queries werden zu schreibgeschützten MCP-Tools
  • Mutations werden zu Schreib-MCP-Tools
  • Input-Typen werden zu Tool-Parametern mit korrekter Validierung
  • Enum-Typen werden zu Parameter-Einschränkungen

Schritt 4: Authentifizierung konfigurieren

Konfigurieren Sie in den Connector-Einstellungen die Authentifizierung für Ihre GraphQL-API. AnythingMCP unterstützt Bearer Tokens, API-Schlüssel und benutzerdefinierte Header. Umgebungsvariablen können für Geheimnisse verwendet werden.

Schritt 5: Anpassen und testen

Überprüfen Sie im Dashboard jedes generierte Tool, passen Sie Namen und Beschreibungen an und wählen Sie, welche Operationen freigegeben werden sollen. Verwenden Sie die integrierte Testoberfläche, um Operationen auszuführen und Antworten zu überprüfen.

Schritt 6: Mit KI-Agenten verbinden

Konfigurieren Sie Ihren MCP-Client, um sich mit dem AnythingMCP-Server zu verbinden:

{
  "mcpServers": {
    "my-graphql-api": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Beliebte GraphQL-APIs zum Verbinden

| Dienst | Anwendungsfall | |--------|----------------| | GitHub | Repository- und Issue-Verwaltung | | Shopify | E-Commerce-Operationen | | Hasura | Datenbankzugriff | | Contentful | Content-Verwaltung | | Strapi | Headless CMS |

Best Practices

  1. Introspektion aktivieren — Stellen Sie sicher, dass Ihr GraphQL-Endpunkt Introspektionsabfragen erlaubt
  2. Mit Queries beginnen — Geben Sie zuerst Leseoperationen frei, dann fügen Sie Mutations hinzu
  3. Verschachtelte Antworten vereinfachen — Passen Sie an, welche Felder in den Tool-Antworten enthalten sein sollen
  4. Ratenbegrenzung — Konfigurieren Sie Ratenlimits, um den GraphQL-Server nicht zu überlasten

Nächste Schritte