Hedera MCP Server

Hedera MCP 服务

一个用于与 Hedera 网络交互的模型上下文协议（MCP）服务。此服务提供创建 Hedera 钱包、查询账户余额、构建交易和发送已签名交易的工具。

⚠️ 安全警告

这是一个演示实现，不应在生产环境中使用。 当前实现存在若干安全漏洞：

• 私钥会在响应正文中发送
• 敏感数据未加密
• 没有交易验证机制

此实现旨在演示 MCP 概念，在生产环境中使用前应妥善加强安全防护。

主要目标

此 MCP 服务的主要目的是演示如何由 MCP 服务处理交易构建和执行，客户端只需验证交易。具体来说：

1. 交易完全由 MCP 服务构建
2. 客户端为构建好的交易签名
3. MCP 服务负责将交易提交到 Hedera 网络
4. 此架构可集中管理交易逻辑，并降低客户端的复杂性

先决条件

• Node.js（v18 或更高版本）
• npm 或 yarn
• Hedera 账户（用于测试网或主网）

安装

1. 克隆此仓库：

   git clone https://github.com/hedera-dev/hedera-mcp-server.git
   cd hedera-mcp-server
   

2. 安装依赖：

   npm install
   

3. 在根目录中创建 .env 文件，并填入你的 Hedera 凭据：

   HEDERA_OPERATOR_ID=your-operator-account-id
   HEDERA_OPERATOR_KEY=your-operator-private-key
   HEDERA_NETWORK=testnet  # or mainnet
   PORT=3000  # optional, defaults to 3000
   

构建应用程序

编译 TypeScript 代码：

npm run build

在开发过程中自动重新编译：

npm run dev

运行服务

启动服务：

npm start

服务将在 http://localhost:3000 上运行（或运行在 .env 文件中指定的端口上）。

使用测试客户端进行测试

此仓库包含一个测试客户端脚本，用于演示如何连接到 MCP 服务并使用其工具。此客户端提供完整的端到端流程，演示所有可用工具。

运行测试客户端：

node test-client.js

测试客户端将：

1. 连接到 MCP 服务
2. 列出可用工具
3. 创建新的 Hedera 钱包（create-wallet 工具）
4. 查询新账户的余额（check-balance 工具）
5. 构建一笔将账户全部余额转入操作员账户的交易（build-transaction 工具）
6. 使用 Hedera SDK 在客户端签署交易
7. 将已签名的交易提交到 Hedera 网络（send-transaction 工具）
8. 显示交易结果

这展示了通过 MCP 服务与 Hedera 网络交互的完整生命周期，从创建账户到提交交易。

可用的 MCP 工具

此服务提供以下工具：

1. create-wallet：创建一个新的 Hedera 账户，并为其设置最低初始余额

   • 无需输入参数
   • 返回账户 ID、公钥和私钥

2. check-balance：查询 Hedera 账户的余额

   • 输入：accountId（字符串）
   • 返回以 tinybar 为单位的账户余额

3. build-transaction：构建一笔转账交易（不签名）

   • 输入：
     • senderAccountId（字符串）
     • recipientAccountId（字符串）
     • amount（数字，单位为 tinybar）
   • 返回 base64 编码的交易

4. send-transaction：将已签名的交易发送到 Hedera 网络

   • 输入：signedTransaction（字符串，base64 编码）
   • 返回交易状态和 ID

部署

此项目包含一个简单的部署脚本：

./deploy.sh

请先为其添加可执行权限：

chmod +x deploy.sh