哈希拉 MCP 服务器

一个与哈希拉网络交互的 Model Context Protocol (MCP) 服务器。此服务器提供创建哈希拉钱包、检查账户余额、构建交易和发送签名交易等功能。

⚠️ 安全警告

这是一个演示实现，不适合在生产环境中使用。 当前实现存在多个安全漏洞：

• 私钥以明文形式返回到响应体中
• 敏感数据未加密
• 无事务验证机制

此实现旨在演示 MCP 概念，并应在投入生产之前进行适当的安全加固。

主要目标

MCP 服务器的主要目的是展示如何通过 MCP 服务器完全处理交易构建和提交，客户端仅需验证交易。具体来说：

1. 交易构建完全在 MCP 服务器上完成
2. 客户端对生成的交易进行签名
3. MCP 服务器负责将交易提交到哈希拉网络
4. 这种架构允许集中化交易逻辑并降低客户端复杂性

先决条件

• 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 工具

服务器提供的工具如下：

1. create-wallet：创建一个新的哈希拉账户，并设置最小初始余额。
2. check-balance：检查指定账户的当前余额。
3. build-transaction：构建一个事务，用于从指定账户转移资金到目标地址。
4. send-transaction：提交签名的事务到哈希拉网络。

每个工具都有特定的输入和输出格式，请参阅相关文档以获取详细信息。

部署

要部署服务器，请运行以下命令：

npm install

然后启动服务器：

npm start

确保您已经配置好了 .env 文件，并且所有依赖项均已安装。