Hyper MCP Ethonline

HyperMCP

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

______________________________________________________________________

概述

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

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

______________________________________________________________________

什么是Envio？

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

______________________________________________________________________

什么是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：查找配置文件

______________________________________________________________________

步骤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命令

______________________________________________________________________

HyperSync命令

______________________________________________________________________

文档命令

______________________________________________________________________

配置命令

______________________________________________________________________

项目结构

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

常见问题

______________________________________________________________________

关键利益

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

______________________________________________________________________

链接

• Envio文档
• HyperSync资源管理器
• 模型上下文协议
• 发送 Discord

______________________________________________________________________

路线图

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

______________________________________________________________________

统计

______________________________________________________________________

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