TheGraph MCP 服务器

一个 MCP 服务器，通过 The Graph 提供的索引区块链数据来增强 AI 代理的能力。

可用工具

1. getSubgraphSchema

获取指定 subgraph 的 schema，为 AI 代理提供生成 GraphQL 查询所需的上下文。

参数：

• subgraphId: subgraph ID (例如, "QmZBQcF...")
• asText: 输出格式标志
  • true: 返回人类可读的 GraphQL schema
  • false: 返回 JSON schema (默认)

2. querySubgraph

针对指定的 subgraph 执行 GraphQL 查询。 虽然查询通常由 AI 生成，但您也可以手动编写自己的查询。

参数：

• subgraphId: subgraph 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"
         }
       }
     }
   }
   

示例提示

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

Schema 查询

• "以可读格式显示 subgraph QmZBQcF... 的 schema"
• "QmZBQcF... subgraph 的结构是什么？请以 GraphQL 格式显示"
• "我需要了解 subgraph QmZBQcF... 的数据模型，你能获取它的 schema 吗？"

数据查询

• "从 subgraph QmZBQcF... 中查找过去 24 小时内交易量排名前 5 的 token"
• "在 subgraph QmZBQcF... 中显示所有流动性大于 100 万美元的 pair"
• "从 QmZBQcF... subgraph 获取最新的 10 个 swap 事件，包括 token 符号和数量"

分析任务

• "使用 subgraph QmZBQcF... 分析过去一周 USDT pair 的交易量"
• "比较 subgraph QmZBQcF... 中 ETH 和 USDC pair 的流动性"
• "从 subgraph QmZBQcF... 中查找过去 24 小时内不寻常的交易模式"

组合任务

• "首先获取 QmZBQcF... 的 schema，然后帮助我编写一个查询来查找高价值交易"
• "检查 QmZBQcF... 的 schema，并告诉我哪些字段可用于查询 token 价格"
• "使用 subgraph QmZBQcF...，通过首先了解 schema 然后查询相关事件来分析大额交易的市场影响"

许可证

本项目采用 MIT 许可证。 有关详细信息，请参阅 LICENSE 文件。