Come convertire API GraphQL in server MCP

GraphQL e MCP: un abbinamento naturale

Lo schema tipizzato e la natura auto-documentante di GraphQL lo rendono una fonte ideale per la generazione di strumenti MCP. AnythingMCP sfrutta l'introspezione GraphQL per creare automaticamente strumenti MCP ben tipizzati dalle tue query e mutation.

Perché convertire GraphQL in MCP?

Sebbene GraphQL sia potente per gli sviluppatori, gli agenti AI necessitano del protocollo MCP per interagire con gli strumenti. Convertendo GraphQL in MCP, permetti agli agenti AI di:

• Interrogare i dati usando il linguaggio naturale invece di scrivere query GraphQL
• Eseguire mutation in modo sicuro con parametri validati
• Navigare le relazioni senza comprendere l'attraversamento del grafo

Guida passo passo

Passaggio 1: Distribuire AnythingMCP

Clona il repository e avvia l'applicazione con Docker Compose:

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Questo avvia PostgreSQL, l'API backend (porta 4000) e la dashboard (porta 3000).

Passaggio 2: Creare un connettore GraphQL

Apri la dashboard di AnythingMCP su http://localhost:3000 e crea un nuovo connettore GraphQL. Fornisci l'URL dell'endpoint GraphQL — AnythingMCP utilizzerà l'introspezione per scoprire automaticamente l'intero schema, incluse tutte le query, le mutation e i tipi.

Passaggio 3: Introspezione dello schema

AnythingMCP esegue automaticamente l'introspezione del tuo schema GraphQL e genera strumenti MCP:

• Le query diventano strumenti MCP in sola lettura
• Le mutation diventano strumenti MCP in scrittura
• I tipi di input diventano parametri degli strumenti con validazione appropriata
• I tipi enum diventano vincoli dei parametri

Passaggio 4: Configurare l'autenticazione

Nelle impostazioni del connettore, configura l'autenticazione per la tua API GraphQL. AnythingMCP supporta token Bearer, chiavi API e header personalizzati. Le variabili d'ambiente possono essere utilizzate per i segreti.

Passaggio 5: Personalizzare e testare

Nella dashboard, rivedi ogni strumento generato, personalizza nomi e descrizioni e scegli quali operazioni esporre. Utilizza l'interfaccia di test integrata per eseguire operazioni e verificare le risposte.

Passaggio 6: Collegare agli agenti AI

Configura il tuo client MCP per connettersi al server AnythingMCP:

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

API GraphQL popolari da collegare

Migliori pratiche

1. Abilita l'introspezione — Assicurati che il tuo endpoint GraphQL consenta le query di introspezione
2. Inizia con le query — Esponi prima le operazioni in lettura, poi aggiungi le mutation
3. Semplifica le risposte annidate — Personalizza quali campi includere nelle risposte degli strumenti
4. Limitazione della frequenza — Configura limiti di frequenza per evitare di sovraccaricare il server GraphQL

Passaggi successivi

• Guida REST a MCP — Converti API REST
• Guida database a MCP — Accesso diretto al database