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 文件，并且所有依赖项均已安装。