Hedera Testnet Mirror Node MCP Server

Hedera 测试网镜像节点 MCP 服务

此代码库包含一个模型上下文协议（MCP）服务，用于与 Hedera 测试网镜像节点 API 交互。 该服务使用 FastMCP 构建，这是一个用于创建 MCP 服务的 TypeScript 框架。 它使用 Zod 模式进行输入验证。

功能

• 端点集成：自动将以 OpenAPI 规范格式定义的 Hedera 镜像节点 API 转换为兼容 MCP 的工具。
• 服务器发送事件（SSE）支持：客户端无法通过 SSE 传输连接到此 MCP 服务。
• 模式验证：使用 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 server started

可通过配置的 SSE 端点访问该服务。

http://localhost:3333/hedera-testnet-mirror-node-api/sse

项目结构

• mcpServer.ts：入口文件，用于初始化并启动 MCP 服务。
• openApiZod.ts：包含镜像节点 API 端点定义，以及使用 zodios 的 API 客户端（类似于添加了 zod 模式定义的 axios）。
  • 请注意，此文件由 openapi-zod-client 以编程方式生成，并经过了一些手动修改。

工作原理

(1) 创建 API 客户端

使用 createApiClient 函数为 Hedera 测试网镜像节点创建 API 客户端。 MCP 服务在此 HTTP API 客户端与自身的 SSE 传输之间进行代理。

(2) 端点转换：

convertZodiosToMcp 函数会处理 endpointDefinitions 中的每个端点定义，具体包括：

• 验证端点使用 GET 方法。
• 将参数映射到 Zod 模式。
• 定义一个执行函数，用于发起相应的 API 调用并返回结果。
• 向 MCP 服务注册该工具。

(3) 服务初始化：

MCP 服务通过 SSE 传输启动。

依赖项

• FastMCP：用于构建 MCP 服务的框架。
• Zod：以 TypeScript 为先的模式声明和验证库。
• openapi-zod-client：根据 OpenAPI 规范文件生成 Zodios 代码。

作者

Brendan Graetz

许可证

MIT