Hedera Dev Hedera MCP Server

🚀 乙太坊 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 服務器。