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