🚀 乙太坊 MCP 服务器

本项目是一个用于与 Hedera 网络交互的模型上下文协议 (MCP) 服务器。它提供了一系列实用工具，如创建 Hedera 钱包、检查账户余额、构建交易以及发送签名交易等，极大地便利了与 Hedera 网络的交互操作。

🚀 快速开始

先决条件

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

安装指南

克隆仓库

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

安装依赖项

npm install

配置环境变量

在根目录下创建一个 .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 网络交互的完整生命周期，从账户创建到交易提交。

✨ 主要特性

服务器提供以下工具：

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 服务器。