区块链索引器对话工具

HyperMCP是一个模型上下文协议(MCP)服务器,通过自然语言集成Envio的区块链索引功能到AI助手如Claude Desktop中,提供35+智能工具帮助开发者构建、查询和管理区块链索引器。

  • by anoop04singh
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 anoop04singh/hyperMCP-ethonline

使用说明

HyperMCP

建造于 @0xanoop 为了 Envio AI+工具黑客马拉松在ETHONLINE


概述

HyperMCP 是一个 模型上下文协议(MCP) 集成的服务器 Envio的区块链索引功能 直接进入AI助手,如 Claude桌面版. 它提供 35+智能工具 供开发人员使用自然语言构建、查询和管理区块链索引器。

阅读deatile指南: HyperMCP:通过对话构建区块链索引器


什么是Envio?

Envio提供 高性能区块链数据基础设施 通过:

组件 描述
HyperIndex 实时区块链索引框架(比子图快100倍)
Hypersync 跨70多个网络的超快速区块链数据查询
HyperRPC 高性能RPC端点

什么是MCP?

这 模型上下文协议(MCP) 允许AI助手与外部数据源和工具安全连接。 HyperMCP 实现此协议,使Envio的堆栈可以通过以下方式访问 对话式人工智能.


特性

HyperMCP提供四类专用工具:

1.HyperIndex工具(代码生成)

  • 项目结构生成

  • Config.yaml创建

  • Schema.graphql生成

  • TypeScript处理程序模板

  • 多链设置

  • 动态合约模式

  • 验证和优化


2.HyperSync工具(数据查询)

  • 跨70多个网络的事件日志查询

  • 交易查询

  • 实时事件流

  • 自定义查询构建

  • 网络端点发现


3.文档工具

  • 在所有Envio文档中进行语义搜索

  • 代码示例检索

  • 配置引用查找

  • 错误排除


4.配置工具

  • 模板生成

  • 网络添加

  • 合同管理

  • 验证助手


快速开始

先决条件

  • Node.js 18+
  • npm或pnpm
  • Claude桌面应用程序
  • 提交 CLI (完整功能可选)

安装

git clone https://github.com/anoop04singh/hyperMCP-ethonline
cd hyperMCP-ethonline
npm install
npm run build

安装Envio CLI (可选但推荐):

npm install -g envio

得到一个 Hypersync API令牌 从 envio.dev/app/api-tokens


连接到克劳德桌面

步骤1:查找配置文件

操作系统 路径
视窗 %APPDATA%\Claude\claude_desktop_config.json
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json

步骤2:添加HyperMCP配置

{
  "mcpServers": {
    "hypermcp": {
      "command": "node",
      "args": ["/absolute/path/to/hypermcp/dist/index.js"],
      "env": {
        "HYPERSYNC_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

替换 /absolute/path/to/hypermcp 根据您的实际项目路径。


步骤3:重新启动克劳德桌面

  • 按 Ctrl+R (Windows/Linux)或 Cmd+R (macOS)
  • 或者退出并重新打开应用程序

步骤4:验证连接

点击 工具图标 在克劳德的界面上。 如果你看到35个以上的HyperMCP工具,你就准备好了。


使用示例

示例1:基于Base创建USDC索引器

你说:

“帮助我在Base上为USDC转账创建一个索引器,从10000000块开始。”

克劳德将:

  • 通过浏览器导入USDC合约
  • 生成传输事件处理程序
  • 验证配置
  • 提供设置说明

示例2:查询最近的Uniswap V3交换

你说:

“向我展示以太坊上最近10次Uniswap V3掉期交易的金额和价格。”

克劳德将:

  • 获取以太坊端点
  • 查询交换事件
  • 使用交易详细信息对结果进行解码和格式化

示例3:多链NFT索引器

你说:

“在以太坊和Base上为无聊猿游艇俱乐部的转账设置一个索引器。”

克劳德将:

  • 两条链的进口合同
  • 配置多链模板
  • 生成 Transfer 处理器
  • 启用无序多链模式

示例4:调试配置

你说:

“我的config.yaml坏了。你能检查一下出了什么问题吗?”

克劳德将:

  • 验证配置文件
  • 诊断错误
  • 建议精确修复

可用工具

HyperIndex命令

工具 说明
hyperindex_check_installation 验证Envio CLI安装
hyperindex_init_project 创建新的索引器项目
hyperindex_init_contract_import_explorer 通过资源管理器导入合约
hyperindex_init_contract_import_local 从本地ABI导入
hyperindex_init_template 使用预构建的模板
hyperindex_dev 启动开发模式
hyperindex_codegen 从配置生成类型
hyperindex_start/stop 管理本地环境
hyperindex_local_docker_up/down 管理docker
hyperindex_local_db_migrate_setup 设置数据库架构
hyperindex_benchmark_summary 查看性能指标
hyperindex_validate_config 验证配置
hyperindex_generate_handler 生成处理程序模板

HyperSync命令

工具 说明
hypersync_query_logs 查询事件日志
hypersync_query_transactions 查询事务
hypersync_build_query 生成自定义查询
hypersync_get_network_endpoint 获取网络URL
hypersync_stream_events 流式传输实时事件

文档命令

工具 说明
docs_search 搜索Envio文档
docs_get_config参考 获取配置参考
docs_get_examples 检索代码示例
docs_故障排除_error 获取错误解决方案

配置命令

工具 说明
config_create_template 生成 config.yaml
config_add_network 添加网络
config_add_contract 添加合约

项目结构

hypermcp/
├── src/
│   ├── index.ts                 # Main MCP server
│   ├── tools/
│   │   ├── hyperindex.ts        # HyperIndex CLI tools
│   │   ├── hypersync.ts         # HyperSync tools
│   │   ├── documentation.ts     # Documentation tools
│   │   └── config.ts            # Config tools
│   └── utils/
│       ├── networks.ts          # Network config
│       ├── validators.ts        # Validation logic
│       ├── templates.ts         # Code templates
│       ├── errors.ts            # Error handling
│       └── constants.ts         # Constants
├── dist/                        # Compiled JS
├── package.json
├── tsconfig.json
└── README.md

建筑

┌─────────────────┐
│  Claude Desktop │
│   (AI Assistant)│
└────────┬────────┘
         │  MCP Protocol
         ▼
┌─────────────────┐
│    HyperMCP     │
│    MCP Server   │
└────────┬────────┘
         │
    ┌────┼────┐
    ▼    ▼    ▼
┌───────┐ ┌──────┐ ┌──────┐
│ Envio │ │ Sync │ │ Docs │
│  CLI  │ │ Tool │ │ API  │
└───────┘ └──────┘ └──────┘

测试

手册

node dist/index.js

预期产量:

Envio MCP Server running on stdio

使用MCP检查器

npx @modelcontextprotocol/inspector node dist/index.js

这将打开一个UI:

  • 查看所有可用工具
  • 交互式测试功能
  • 检查请求和响应

调试

检查日志

macOS:

tail -f ~/Library/Logs/Claude/mcp*.log

窗户:

type %APPDATA%\Claude\logs\mcp*.log

常见问题

问题 解决方案
工具未显示 验证配置路径和JSON语法
找不到Envio二进制文件 npm install -g envio
权限错误 以管理员身份运行终端
API代币问题 获取新代币并重新启动Claude

关键利益

  • 自然语言接口
  • 即时文档访问
  • 错误预防和验证
  • 自动代码生成
  • 多链兼容性
  • 实时区块链查询
  • 基于模板的设置
  • 最佳实践建议

链接


路线图

  • 添加支持 燃料区块链索引
  • 实施 GraphQL查询生成器
  • 添加 子图迁移工具
  • 创建 可视化配置编辑器
  • 添加 部署到托管服务
  • 启用 实时同步监控
  • 添加 自定义RPC端点支持
  • 提供 示例模板

统计

度量 值
MCP工具 35+
支持的网络 70+
核心模块 3(HyperIndex、HyperSync、文档)
语言 100%TypeScript
数据 实时区块链流

建造于 @0xanoop Envio AI+工具黑客马拉松