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

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

特征

• 端点集成：自动将以 OpenAPI 规范格式定义的 Hedera Mirror Node API 转换为与 MCP 兼容的工具。

• 服务器发送事件 (SSE) 支持：客户端无法通过 SSE 传输连接到此 MCP 服务器。

• 模式验证：确保请求参数符合使用 Zod 定义的模式。

Related MCP server: MCP-OpenAPI

先决条件

在运行服务器之前，请确保已安装以下内容：

• 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）端点转换：

来自endpointDefinitions的每个端点定义都由convertZodiosToMcp函数处理，该函数：

• 验证端点是否使用GET方法。

• 将参数映射到 Zod 模式。

• 定义一个执行函数，进行相应的API调用并返回结果。

• 向 MCP 服务器注册该工具。

（3）服务器初始化：

MCP 服务器通过 SSE 传输启动。

依赖项

• FastMCP ：用于构建 MCP 服务器的框架。

• Zod ：TypeScript 优先的模式声明和验证库。

• openapi-zod-client ：从 OpenAPI 规范文件生成 Zodios 代码。

作者

布伦丹·格雷茨

执照

麻省理工学院