SuperAPI AI 工具集

thegraph-mcp-skill

数据与分析

查看项目

更新于 10-15 22:14

技能介绍

用途:借助 uxc 连接 The Graph Subgraph MCP 的原生 SSE 端点,完成子图发现、schema 获取、部署选择与 GraphQL 查询执行,并复用 uxc 的协议发现、信封解析与错误处理规则。

前提:uxc 已安装并在 PATH 中;可访问 https://subgraphs.mcp.thegraph.com/sse;具备 The Graph Gateway API key,该端点要求以 Authorization: Bearer <key> 方式发送。

初始化与固定命令:先用 uxc https://subgraphs.mcp.thegraph.com/sse -h 探测确认协议为 mcp;注册凭据并绑定主机:uxc auth credential set thegraph --secret-env THEGRAPH_API_KEY;uxc auth binding add --id thegraph-sse --host subgraphs.mcp.thegraph.com --path-prefix /sse --scheme https --credential thegraph --priority 100;用 command -v thegraph-mcp-cli 检查,缺失则执行 uxc link thegraph-mcp-cli https://subgraphs.mcp.thegraph.com/sse。若检测到命令冲突且无法安全复用,应停止并请维护者更换固定命令名。默认走 thegraph-mcp-cli,它与配置相同绑定后的 uxc 直连端点等价。

主要能力:发现类含按关键词搜索子图、按合约查找热门部署、查看部署热度与 30 天查询量;schema 类含按部署 ID、子图 ID、IPFS 哈希获取 schema;查询类含按上述三种标识执行 GraphQL 查询。

使用建议:保持 JSON 输出信封,不依赖 --text;优先解析 ok、kind、protocol、data、error 等稳定字段。执行前先用 thegraph-mcp-cli -h 与 <operation> -h 查看操作 schema,优先做发现与 schema 检查,理解标识与结构后再执行查询。生产流程优先按部署选择,而非松散的 latest 版本引用。首次查询应缩小范围:加过滤、加 limit、只取必要字段。

鉴权失败排查:确认 uxc auth credential info thegraph 成功;确认 uxc auth binding match https://subgraphs.mcp.thegraph.com/sse 解析到 thegraph;再重跑 thegraph-mcp-cli -h。

限制与实测:资料仅提供上述能力与流程,其他功能、收费、价格、平台或效果暂未提供。已实测流程为搜索 uniswap 子图、用 get_deployment_30day_query_counts 比较候选、选查询量最高者、获取 schema、执行最小 _meta 查询;该次所选子图 ID 为 5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV,部署 IPFS 哈希为 QmTZ8ejXJxRo7vDBS4uwqBeGoxLSWbhaA7oXa1RvxunLy7,验证查询为 { _meta { deployment hasIndexingErrors } }。