Hts MCP Server

🚀 哈希拉 MCP 服務器

哈希拉 MCP 服務器用於與哈希拉網絡進行交互，它基於 Model Context Protocol (MCP) 構建。該服務器具備創建哈希拉錢包、查詢賬戶餘額、構建交易以及發送簽名交易等功能。

🚀 快速開始

先決條件

• Node.js（版本 v18 或更高）
• npm 或 yarn
• 一個哈希拉賬戶（可用於測試網或主網）

安裝步驟

1. 克隆此倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 在項目根目錄下創建一個 .env 文件，包含您的哈希拉憑證：

   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. 創建一個新的哈希拉錢包（create - wallet 工具）
4. 檢查新賬戶的餘額（check - balance 工具）
5. 構建一個向操作員賬戶轉移賬戶全部餘額的交易（build - transaction 工具）
6. 使用哈希拉 SDK 在客戶端簽名事務
7. 提交簽名的事務到哈希拉網絡（send - transaction 工具）
8. 顯示事務結果

這展示了通過 MCP 服務器與哈希拉網絡交互的完整生命週期，從賬戶創建到事務提交。

✨ 主要特性

MCP 服務器的主要目的是展示如何通過 MCP 服務器完全處理交易構建和提交，客戶端僅需驗證交易。具體來說：

1. 交易構建完全在 MCP 服務器上完成
2. 客戶端對生成的交易進行簽名
3. MCP 服務器負責將交易提交到哈希拉網絡
4. 這種架構允許集中化交易邏輯並降低客戶端複雜性

⚠️ 重要提示

這是一個演示實現，不適合在生產環境中使用。當前實現存在多個安全漏洞：

• 私鑰以明文形式返回到響應體中
• 敏感數據未加密
• 無事務驗證機制

此實現旨在演示 MCP 概念，並應在投入生產之前進行適當的安全加固。

📦 安裝指南

克隆倉庫

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

安裝依賴

npm install

配置環境變量

在項目根目錄下創建一個 .env 文件，包含您的哈希拉憑證：

HEDERA_OPERATOR_ID=your-operator-account-id
HEDERA_OPERATOR_KEY=your-operator-private-key
HEDERA_NETWORK=testnet  # 或 mainnet
PORT=3000  # 可選，默認為 3000

💻 使用示例

基礎用法

啟動服務器

npm start

服務器將在 http://localhost:3000（或您指定的端口）上運行。

運行測試客戶端

node test-client.js

測試客戶端將執行一系列操作，展示與 MCP 服務器的交互流程。

高級用法

編譯應用程序

編譯 TypeScript 代碼：

npm run build

對於開發環境下的自動重新編譯：

npm run dev

📚 詳細文檔

可用的 MCP 工具

服務器提供的工具如下：

1. create - wallet：創建一個新的哈希拉賬戶，並設置最小初始餘額。
2. check - balance：檢查指定賬戶的當前餘額。
3. build - transaction：構建一個事務，用於從指定賬戶轉移資金到目標地址。
4. send - transaction：提交簽名的事務到哈希拉網絡。

每個工具都有特定的輸入和輸出格式，請參閱相關文檔以獲取詳細信息。

部署

要部署服務器，請運行以下命令：

npm install

然後啟動服務器：

npm start

確保您已經配置好了 .env 文件，並且所有依賴項均已安裝。