TheGraph MCP Server

TheGraph MCP 服务

一个 MCP 服务，通过 The Graph 中已索引的区块链数据为 AI Agent 提供支持。

可用工具

1. getSubgraphSchema

获取指定子图的架构，为 AI Agent 提供生成 GraphQL 查询所需的上下文。

参数：

• subgraphId：子图 ID（例如，“QmZBQcF...”）
• asText：输出格式标记
  • true：返回易于阅读的 GraphQL 架构
  • false：返回 JSON 架构（默认）

2. querySubgraph

对指定子图执行 GraphQL 查询。虽然查询通常由 AI 生成，但你也可以手动编写查询。

参数：

• subgraphId：子图 ID
• query：GraphQL 查询字符串

安装

1. 克隆仓库

   git clone https://github.com/kukapay/thegraph-mcp.git
   

2. 客户端配置

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

示例提示词

以下是一些可用于触发工具的自然语言提示词：

架构查询

• “以易读的格式显示子图 QmZBQcF... 的架构”
• “QmZBQcF... 子图的结构是什么？请以 GraphQL 格式显示”
• “我想了解子图 QmZBQcF... 的数据模型，可以获取它的架构吗？”

数据查询

• “从子图 QmZBQcF... 中找出过去 24 小时交易量最高的 5 种代币”
• “显示子图 QmZBQcF... 中所有流动性超过 100 万美元的交易对”
• “获取 QmZBQcF... 子图中最新的 10 条兑换事件，包括代币符号和数量”

分析任务

• “使用子图 QmZBQcF... 分析过去一周 USDT 交易对的交易量”
• “比较子图 QmZBQcF... 中 ETH 和 USDC 交易对的流动性”
• “从子图 QmZBQcF... 中找出过去 24 小时的异常交易模式”

组合任务

• “先获取 QmZBQcF... 的架构，然后帮我编写一个查询，以找出高价值交易”
• “检查 QmZBQcF... 的架构，并告诉我有哪些字段可用于查询代币价格”
• “使用子图 QmZBQcF... 分析大额交易对市场的影响：先了解架构，再查询相关事件”

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。