In breve
Collega qualsiasi API GraphQL al Model Context Protocol. Consenti agli agenti AI di interrogare e modificare i dati attraverso endpoint GraphQL utilizzando AnythingMCP.
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
| Servizio | Caso d'uso |
|---|---|
| GitHub | Gestione repository e issue |
| Shopify | Operazioni e-commerce |
| Hasura | Accesso al database |
| Contentful | Gestione dei contenuti |
| Strapi | CMS headless |
Migliori pratiche
- Abilita l'introspezione — Assicurati che il tuo endpoint GraphQL consenta le query di introspezione
- Inizia con le query — Esponi prima le operazioni in lettura, poi aggiungi le mutation
- Semplifica le risposte annidate — Personalizza quali campi includere nelle risposte degli strumenti
- 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
Questa guida ti è stata utile?
