Hedera MCP Server
2025.04.11
0
TypeScript去中心化通信AI 代理Hedera 网络交流协作开发效率
Hedera MCP Server 是一个基于 Node.js (TypeScript) 的生产级模块化服务器，旨在支持 Hedera 网络上 AI 代理之间的去中心化通信。它采用 Model-Context-Protocol (MCP) 架构，提供 RESTful API 和基于 SSE (Server-Sent Events) 的 MCP 接口。该服务器支持多种 Hedera 共识服务 (HCS) 标准，包括文件/数据管理、代理发现、大消息处理、代理通信协议和去中心化身份/配置文件管理。适用于构建 AI 集成的去中心化应用的开发者和黑客马拉松参与者。
View on GitHub
Overview
基本能力
产品定位
Hedera MCP Server 是一个支持 AI 代理在 Hedera 网络上进行去中心化通信的服务器，提供 RESTful API 和 SSE 接口。
核心功能
- 代理注册与配置文件管理 (HCS-11)：创建或导入 Hedera 账户，设置代理的入站/出站主题和链上配置文件。
- 代理发现 (HCS-2)：在中心化注册主题中注册代理，并通过搜索 API 按名称或能力发现代理。
- 安全通信 (HCS-10)：发起和接受代理之间的连接请求，建立专用连接主题进行消息交换。
- 大消息处理 (HCS-1 & HCS-3)：将大消息内容存储在专用文件主题中，并在消息中返回 HRL (HCS Resource Locator) 引用。
- MCP 接口 (SSE)：通过 FastMCP 提供 MCP 兼容的 SSE 端点，支持 AI 工具直接调用服务器工具。
- RESTful API：提供代理操作、连接管理和消息传递的 HTTP 端点。
- 生产级部署：支持 Docker 和 Docker Compose 一键部署。
适用场景
- 构建 AI 集成的去中心化应用。
- 黑客马拉松项目开发。
- 代理之间的安全通信和消息传递。
工具列表
- FastMCP：用于实现 MCP 兼容的 SSE 接口。
- Hedera Agent Kit：支持代理注册和配置文件管理。
- Standards Agent Kit：支持多种 HCS 标准。
常见问题解答
- 环境变量配置：需设置
HEDERA_OPERATOR_ID和HEDERA_OPERATOR_KEY。 - 测试网络：确保测试环境有足够的 HBAR 用于交易。
使用教程
使用依赖
- Node.js ≥ 18 (LTS 推荐)
- npm (随 Node 安装)
- Docker 和 Docker Compose (用于容器部署)
安装教程
- 克隆仓库
bash git clone https://github.com/hgraphpunks/hedera-mcp-server.git cd hedera-mcp-server - 安装依赖
bash npm install - 配置环境变量
创建
.env文件并填入以下内容：ini HEDERA_NETWORK=testnet HEDERA_OPERATOR_ID=0.0.12345 HEDERA_OPERATOR_KEY=302e0201... REGISTRY_TOPIC_ID= PORT=3000 SSE_PORT=3001 - 构建项目
bash npm run build - 运行服务器
bash npm start
调试方式
- 开发模式
bash npm run dev - 测试
bash npm test