Hedera MCP 服务器

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

前提条件

• 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=您的-operator-账户-ID
   HEDERA_OPERATOR_KEY=您的-operator-私钥
   HEDERA_NETWORK=testnet  # 或 mainnet
   PORT=3000  # 可选，默认为 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. 构建一个将账户的全部余额转移到 operator 账户的交易（build-transaction 工具）
6. 使用 Hedera SDK 在客户端对交易进行签名
7. 将签名后的交易提交到 Hedera 网络（send-transaction 工具）
8. 显示交易结果

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

可用的 MCP 工具

服务器提供以下工具：

1. create-wallet: 创建一个新的 Hedera 账户，并具有最小的初始余额

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

2. check-balance: 检查 Hedera 账户的余额

   • 输入：accountId (字符串)
   • 返回以 tinybars 为单位的账户余额

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

   • 输入：
     • senderAccountId (字符串)
     • recipientAccountId (字符串)
     • amount (数字，以 tinybars 为单位)
   • 返回一个 base64 编码的交易

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

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

部署

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

./deploy.sh

请务必先使其可执行：

chmod +x deploy.sh