Hedera Dev_mirrornode Mcp Server

🚀 测试网镜像节点 MCP 服务器（Hedera）

本项目仓库里有一个能和 Hedera Testnet Mirror Node API 接口交互的 Model Context Protocol (MCP) 服务器。它借助 FastMCP 这个用于创建 MCP 服务器的 TypeScript 框架，还利用 Zod 方案来做输入验证。

🚀 快速开始

此 MCP 服务器可与 Hedera Testnet Mirror Node API 接口交互。它能自动转换 API 端点，支持模式验证，还可通过 SSE 端点访问。

✨ 主要特性

• 端点集成：自动把 Hedera Mirror Node 的 APIs（以 OpenAPI 规范格式定义）转化成与 MCP 兼容的工具。
• 服务器发送事件 (SSE) 支持：客户端无法通过此 MCP 服务器使用 SSE 运输连接。
• 模式验证：利用 Zod 验证，确保请求参数符合定义的模式。

📦 安装指南

在运行服务器之前，要确保安装了 Bun 或其他能直接运行 TypeScript 的环境。 (1) 克隆仓库

git clone https://github.com/hedera-dev/mirrornode-mcp-server

(2) 进入项目目录

cd mirrornode-mcp-server

(3) 安装依赖项

npm install

💻 使用示例

基础用法

要启动 MCP 服务器：

bun mcpServer.ts

成功启动后，会看到：

MCP 服务器已启动

该服务器可通过配置的 SSE 端点访问： http://localhost:3333/hedera-testnet-mirror-node-api/sse

📚 详细文档

项目结构

• mcpServer.ts：入口文件，用于初始化并启动 MCP 服务器。
• openApiZod.ts：包含 Mirror Node API 端点定义和使用 zodios（类似于 axios 增强版）的 API 客户端。
  • 注意该文件是通过 openapi-zod-client 自动生成，再加上一些手动修改。

工作原理

(1) API 客户端创建：使用 createApiClient 函数为 Hedera Testnet Mirror Node 创建一个 API 客户端。MCP 服务器在 HTTP API 客户端和自身的 SSE 运输之间进行代理。 (2) 端点转换：从 endpointDefinitions 处理每个端点定义，使用 convertZodiosToMcp 函数：

• 验证该端点是否使用 GET 方法。
• 将参数映射到 Zod 模式。
• 定义一个执行函数以进行相应的 API 调用并返回结果。
• 在 MCP 服务器上注册工具。 (3) 服务器初始化：使用 SSE 运输启动 MCP 服务器。

依赖项

• FastMCP：构建 MCP 服务器的框架。
• Zod：用于 TypeScript 先行方案声明和验证的库。
• openapi-zod-client：从 OpenAPI 规范文件生成 Zodios 代码。

作者

Brendan Graetz

📄 许可证

本项目采用 MIT 许可证。