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 

# 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服务器 -此技能与MCP服务器交互
• 克劳德代码 -AI编码辅助平台