乙太坊 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=your-operator-account-id
   HEDERA_OPERATOR_KEY=your-operator-private-key
   HEDERA_NETWORK=testnet  # 或 mainnet
   PORT=3000  # 可选，默认为 3000
   

编译应用程序

编译 TypeScript 代码：

npm run build

用于开发且带有自动重新编译功能的命令：

npm run dev

运行服务器

启动服务器：

npm start

服务器将在 http://localhost:3000（或你指定的端口）上运行。

使用测试客户端进行测试

此仓库包含一个测试客户端脚本，演示如何连接到 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（字符串）
   • 返回账户余额，单位为 tinybars

3. build-transaction：构建一个未签名的转账交易

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

4. send-transaction：将签名交易提交到 Hedera 网络

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

部署

运行部署脚本：

chmod +x deploy.sh
./deploy.sh

此脚本将启动你的 MCP 服务器。