AI导哈

区块链子图查询工具

一个用于通过私有MCP服务器在Docker中探索和查询区块链子图的Claude Code技能，提供Docker管理、GraphQL模式探索、查询执行和导出功能。

  • by nschwermann
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nschwermann/subgraph-explorer-skill

使用说明

子图浏览器技能

Claude Code技能，用于通过在Docker中运行的私有MCP服务器探索和查询区块链子图。

描述

该技能允许通过私有MCP服务器探索和查询区块链子图。它提供了用于管理基于Docker的服务器、探索GraphQL模式、对配置的子图执行查询以及导出发现的查询以进行项目集成的工具。

特性

  • Docker管理：启动、停止和检查MCP服务器的状态
  • 模式探索：从子图中反思GraphQL模式
  • 查询执行：对已配置或特殊的子图端点执行GraphQL查询
  • 查询导出：以多种格式（JS、Python、GraphQL、JSON）保存发现的查询
  • 综合模式：区块链数据常见GraphQL查询模式的参考指南

用例

  • 探索NFT转移和所有权数据
  • 查询DEX掉期和交易量
  • 分析DeFi协议度量
  • 检查子图模式和实体
  • 导出项目集成查询

需求

  • Docker和Docker Compose
  • 私有子图MCP服务器(https://github.com/nschwermann/subgraph-mcp)
  • Python 3（用于查询导出实用程序）

安装

作为Claude代码技能

  1. 下载 subgraph-explorer.zip 文件
  2. 通过Claude Code插件系统安装，或
  3. 提取到您的Claude技能目录

来源

# Clone or download this repository
git clone <repository-url>

# The skill is ready to use
# Scripts are in scripts/
# Reference docs are in references/
# Main instructions are in SKILL.md

快速开始

启动MCP服务器

bash scripts/start_mcp_server.sh

Docker容器的开头是：

  • SSE端点: http://localhost:8000 （用于MCP通信）
  • 指标端点: http://localhost:9091/metrics （用于监控）

检查服务器状态

bash scripts/check_mcp_status.sh

停止服务器

bash scripts/stop_mcp_server.sh

导出查询

导出发现的GraphQL查询以供项目使用：

JavaScript/TypeScript

python3 scripts/export_query.py queries/myQuery.js --format js --name MyQuery

python

python3 scripts/export_query.py queries/myQuery.py --format py --name my_query

图查询语言

python3 scripts/export_query.py queries/myQuery.graphql --format graphql

JSON

python3 scripts/export_query.py queries/myQuery.json --format json --name MyQuery

结构

subgraph-explorer/
├── SKILL.md                           # Main skill documentation
├── scripts/
│   ├── start_mcp_server.sh           # Start Docker MCP server
│   ├── stop_mcp_server.sh            # Stop Docker MCP server
│   ├── check_mcp_status.sh           # Check server status
│   └── export_query.py               # Export queries to various formats
└── references/
    └── graphql_patterns.md           # GraphQL query patterns reference

配置

脚本默认为 ~/Workspace/subgraph-mcp 作为MCP服务器项目路径。通过设置覆盖 SUBGRAPH_MCP_PATH 环境变量：

export SUBGRAPH_MCP_PATH=/path/to/your/subgraph-mcp
bash scripts/start_mcp_server.sh

MCP服务器工具

该技能适用于以下MCP服务器工具：

基于注册表：

  • list_subgraphs -列出所有已配置的子图
  • search_subgraphs_by_keyword -按关键字搜索子图
  • get_schema_by_id -获取子图的GraphQL模式
  • execute_query_by_id -对子图执行查询
  • get_query_examples_by_id -获取查询示例
  • get_subgraph_guidance_by_id -获取子图特定指导

临时：

  • get_schema_by_url -从任何GraphQL端点获取架构
  • execute_query_by_url -对任何GraphQL端点执行查询

文档

看 SKILL.md 获取全面的文件，包括：

  • 子图探索的核心工作流程
  • 查询开发过程
  • 数据考虑因素和最佳做法
  • 故障排除指南
  • 提示和技巧

看 references/graphql_patterns.md 用于：

  • 分页策略
  • 过滤和聚合模式
  • 性能优化技术
  • 常见查询场景

许可证

麻省理工学院

相关项目

相关 MCP