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

此仓库包含一个与 Hedera 测试网镜像节点 API 接口的 Model Context Protocol (MCP) 服务器。 该服务器使用 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-mcserver

(3) 安装依赖项

npm install

使用方法

启动 MCP 服务器：

bun mcpServer.ts

成功启动后，您应该看到：

MCP 服务器已启动

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

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

项目结构

• mcpServer.ts：初始化并启动 MCP 服务器的入口点。
• openApiZod.ts：包含镜像节点 API 端点定义以及使用 zodios（类似于 axios 并带有 zod 模式定义）的 API 客户端。
  • 注意：此文件是通过 openapi-zod-client 自动生成的，并进行了部分手动修改。

工作原理

(1) 创建 API 客户端

使用 createApiClient 函数为 Hedera 测试网镜像节点创建一个 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