TheGraph MCP Server

Cosa fa il server MCP “TheGraph”?

TheGraph MCP Server è un livello di integrazione che collega agenti AI con dati blockchain indicizzati dal protocollo The Graph. Consente ai sistemi AI di accedere, interrogare e analizzare informazioni blockchain in modo efficiente esponendo dati subgraph tramite strumenti standardizzati MCP (Model Context Protocol). Consentendo agli assistenti di recuperare schemi dei subgraph ed eseguire query GraphQL, TheGraph MCP Server facilita flussi di sviluppo che coinvolgono analytics blockchain, recupero dati on-chain e monitoraggio della finanza decentralizzata (DeFi). Questo server rende possibile a sviluppatori e agenti AI recuperare dati blockchain strutturati, effettuare analisi automatizzate e creare applicazioni che interagiscono senza interruzioni con la rete di indicizzazione decentralizzata di The Graph.

Elenco dei Prompt

• Query Schema
  • Prompt per recuperare e visualizzare lo schema di un determinato subgraph, come la richiesta di uno schema GraphQL leggibile o la comprensione della struttura del modello dati.
• Query Dati
  • Prompt per ottenere dati specifici da un subgraph, come trovare i token principali per volume di scambi, recuperare coppie con alta liquidità o elencare eventi di swap recenti.
• Task di Analisi
  • Prompt per eseguire analisi su dati blockchain, come l’analisi dei volumi di trading per token specifici su determinati intervalli temporali.

Elenco delle Risorse

Nessuna risorsa MCP esplicita è documentata nel repository.

Elenco degli Strumenti

• getSubgraphSchema
  • Recupera lo schema di un subgraph specificato, consentendo agli agenti AI di comprendere la struttura e il formato dei dati blockchain indicizzati da The Graph.
• querySubgraph
  • Esegue query GraphQL su un subgraph designato, permettendo il recupero di set di dati personalizzati e analisi direttamente dai dati blockchain indicizzati da The Graph.

Casi d’Uso per questo MCP Server

• Analytics Dati Blockchain
  • Sviluppatori e agenti AI possono analizzare dati on-chain, come volumi di scambi o liquidità, per fornire insight a piattaforme DeFi o trading bot.
• Esplorazione Schema per Sviluppatori
  • Consente il recupero rapido degli schemi dei subgraph per comprendere i modelli dati, accelerando lo sviluppo di applicazioni integrate con blockchain.
• Monitoraggio e Reportistica DeFi
  • Monitoraggio automatico delle metriche finanziarie (es. token principali, eventi swap) per exchange e asset decentralizzati tramite query ai subgraph.
• Recupero Dati Personalizzato
  • Facilita l’estrazione di dati blockchain specifici per ricerca, dashboard o analytics in tempo reale tramite query GraphQL personalizzate.
• Assistenti Blockchain AI-powered
  • Alimenta agenti che possono rispondere a domande o automatizzare task basati su dati blockchain, come avvisi su transazioni insolite o generazione di report.

Come configurarlo

Windsurf

1. Prerequisiti: Assicurati che Python 3.10+ e uv siano installati.
2. Clona il repository:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Modifica il file di configurazione: Individua la tua configurazione Windsurf (ad es. config.json).
4. Aggiungi TheGraph MCP Server:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Salva e riavvia Windsurf.
6. Verifica: Testa con un prompt di schema o query dati.

Claude

1. Prerequisiti: Python e uv installati.
2. Clona il repository:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Aggiorna le impostazioni MCP di Claude: Modifica la configurazione di Claude.
4. Inserisci i dettagli del server:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Riavvia Claude e testa la connettività.

Cursor

1. Installa i prerequisiti: Python 3.10+ e uv.
2. Clona il repository:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Modifica il file config MCP di Cursor.
4. Aggiungi il seguente JSON:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Riavvia Cursor e verifica eseguendo una query di test.

Cline

1. Prerequisiti: Assicurati che Python 3.10+ e uv siano disponibili.
2. Clona il repository:
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Modifica il file di configurazione di Cline.
4. Inserisci quanto segue nella tua configurazione MCP:

   {
     "mcpServers": {
       "thegraph-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
         "env": {
           "THEGRAPH_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

5. Riavvia Cline, quindi testa con un prompt.

Protezione delle API Key

• Conserva la tua THEGRAPH_API_KEY come variabile d’ambiente.
• Esempio di configurazione:

  {
    "mcpServers": {
      "thegraph-mcp": {
        "command": "uv",
        "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
        "env": {
          "THEGRAPH_API_KEY": "${THEGRAPH_API_KEY}"
        }
      }
    }
  }
  

Come usare questo MCP nei flow

Utilizzo di MCP in FlowHunt

Per integrare server MCP nel tuo flusso FlowHunt, inizia aggiungendo il componente MCP al tuo flusso e collegandolo al tuo agente AI:

Clicca sul componente MCP per aprire il pannello di configurazione. Nella sezione di configurazione MCP di sistema, inserisci i dettagli del tuo server MCP usando questo formato JSON:

{
  "thegraph-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Una volta configurato, l’agente AI potrà ora usare questo MCP come strumento con accesso a tutte le sue funzioni e capacità. Ricorda di cambiare “thegraph-mcp” con il nome effettivo del tuo server MCP e di sostituire l’URL con quello del tuo server MCP.

Panoramica

La nostra opinione

TheGraph MCP Server offre un’interfaccia chiara e due strumenti essenziali per interagire con i dati blockchain indicizzati da The Graph. La documentazione copre configurazione e sicurezza, ma manca di dettagli su risorse MCP esplicite, roots o sampling. Nel complesso, è diretto e funzionale per l’uso previsto.

Valutazione: 7/10

MCP Score