Serveur TheGraph MCP

Que fait le serveur “TheGraph” MCP ?

Le serveur TheGraph MCP est une couche d’intégration qui connecte les agents IA à des données blockchain indexées via le protocole The Graph. Il permet aux systèmes d’IA d’accéder, d’interroger et d’analyser efficacement des informations blockchain en exposant les données des sous-graphes via des outils MCP (Model Context Protocol) standardisés. En permettant aux assistants de récupérer les schémas de sous-graphes et d’exécuter des requêtes GraphQL, TheGraph MCP Server facilite des workflows de développement impliquant l’analytique blockchain, la récupération de données on-chain et la surveillance de la finance décentralisée (DeFi). Ce serveur permet aux développeurs et agents IA de récupérer des données blockchain structurées, d’effectuer des analyses automatisées et de concevoir des applications interagissant de façon transparente avec le réseau d’indexation décentralisé de The Graph.

Liste des invites

• Requêtes de schéma
  • Prompts pour récupérer et afficher le schéma d’un sous-graphe donné, par exemple pour demander un schéma GraphQL lisible ou comprendre la structure du modèle de données.
• Requêtes de données
  • Prompts pour extraire des données spécifiques d’un sous-graphe, comme trouver les principaux tokens par volume de trading, récupérer les paires avec une forte liquidité ou lister les événements de swap récents.
• Tâches d’analyse
  • Prompts pour réaliser des analyses sur des données blockchain, comme analyser les volumes de trading pour des tokens spécifiques sur des périodes définies.

Liste des ressources

Aucune ressource MCP explicite n’est documentée dans le dépôt.

Liste des outils

• getSubgraphSchema
  • Récupère le schéma d’un sous-graphe spécifié, permettant aux agents IA de comprendre la structure et le format des données blockchain indexées par The Graph.
• querySubgraph
  • Exécute des requêtes GraphQL sur un sous-graphe désigné, permettant de récupérer des ensembles de données personnalisés et des analyses directement depuis les données blockchain indexées de The Graph.

Cas d’usage de ce serveur MCP

• Analytique des données blockchain
  • Les développeurs et agents IA peuvent analyser des données on-chain, comme les volumes de trading ou la liquidité, pour fournir des insights pour des plateformes DeFi ou des bots de trading.
• Exploration de schéma pour développeurs
  • Permet de récupérer rapidement les schémas des sous-graphes pour comprendre les modèles de données, accélérant le développement d’applications intégrées à la blockchain.
• Surveillance et reporting DeFi
  • Surveillance automatisée des métriques financières (ex : tokens principaux, événements de swap) pour des exchanges et actifs décentralisés grâce à des requêtes sur les sous-graphes.
• Récupération personnalisée de données
  • Facilite l’extraction de données blockchain spécifiques pour la recherche, des dashboards ou de l’analytique en temps réel via la création et l’exécution de requêtes GraphQL personnalisées.
• Assistants blockchain pilotés par IA
  • Alimente des agents capables de répondre à des questions ou d’automatiser des tâches basées sur les données blockchain, comme alerter sur des transactions inhabituelles ou générer des rapports.

Comment l’installer

Windsurf

1. Prérequis : Assurez-vous que Python 3.10+ et uv sont installés.
2. Cloner le dépôt :
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Modifier le fichier de configuration : Localisez votre config Windsurf (ex. config.json).
4. Ajouter le serveur TheGraph MCP :

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

5. Sauvegardez et redémarrez Windsurf.
6. Vérification : Testez avec une invite de requête de schéma ou de données.

Claude

1. Prérequis : Python et uv installés.
2. Cloner le dépôt :
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Mettre à jour les paramètres MCP de Claude : Modifiez votre config Claude.
4. Insérer les détails serveur :

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

5. Redémarrez Claude et testez la connectivité.

Cursor

1. Installer les prérequis : Python 3.10+ et uv.
2. Cloner le dépôt :
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Modifier le fichier de configuration MCP de Cursor.
4. Ajouter le JSON suivant :

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

5. Redémarrez Cursor et vérifiez avec une requête de test.

Cline

1. Prérequis : Assurez-vous que Python 3.10+ et uv sont disponibles.
2. Cloner le dépôt :
   git clone https://github.com/kukapay/thegraph-mcp.git
3. Modifier le fichier de configuration de Cline.
4. Insérer ce qui suit dans votre config MCP :

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

5. Redémarrez Cline puis testez avec une invite.

Sécurisation des clés API

• Stockez votre THEGRAPH_API_KEY comme variable d’environnement.
• Exemple de configuration :

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

Comment utiliser ce MCP dans des flows

Utilisation de MCP dans FlowHunt

Pour intégrer des serveurs MCP dans votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flow et connectez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section configuration système MCP, insérez les détails de votre serveur MCP avec ce format JSON :

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

Une fois configuré, l’agent IA peut désormais utiliser ce MCP comme outil avec accès à toutes ses fonctions et capacités. N’oubliez pas de remplacer “thegraph-mcp” par le vrai nom de votre serveur MCP et l’URL par celle de votre serveur MCP.

Aperçu

Notre avis

Le serveur TheGraph MCP fournit une interface claire et deux outils essentiels pour interagir avec les données blockchain indexées par The Graph. La documentation couvre l’installation et la sécurité, mais manque de détails sur les ressources MCP explicites, les racines ou l’échantillonnage. Globalement, il est simple et fonctionnel pour son usage attendu.

Note : 7/10

Score MCP