Thegraph MCP

🚀 TheGraph MCP 服务器

这是一个由区块链索引数据驱动的 AI 代理服务器，借助 The Graph 的子图数据运行，为区块链数据的查询和分析提供便利。

🚀 快速开始

TheGraph MCP 服务器是一个强大的工具，它能基于区块链索引数据为 AI 代理提供支持，帮助用户通过自然语言触发工具来查询和分析子图数据。

✨ 主要特性

可用工具

1. 获取子图模式

该工具可获取指定子图的模式，为 AI 代理生成 GraphQL 查询提供必要的上下文。 参数:

• subgraphId：子图 ID（例如 "QmZBQcF..."）
• asText：输出格式标志
  • true：返回人类可读的 GraphQL 模式
  • false：返回 JSON 模式（默认）

2. 查询子图

可对指定子图执行 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... 的数据模型，请帮我获取其模式"

数据查询

• "找出过去 24 小时内交易量排名前 5 的代币来自子图 QmZBQcF..."
• "显示所有流动性超过 100 万美元的对来自子图 QmZBQcF..."
• "获取最新的 10 条交换事件来自子图 QmZBQcF...，包括代币符号和金额"

分析任务

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

综合任务

• "首先获取子图 QmZBQcF... 的模式，然后帮我编写查询高价值交易的查询"
• "检查子图 QmZBQcF... 的模式并告诉我可用于查询代币价格的字段"
• "使用子图 QmZBQcF... 分析大额交易的市场影响，首先了解模式然后查询相关事件"

📄 许可证

该项目遵循 MIT License 授权。如需详细信息，请查看 LICENSE 文件。