🚀 哈希拉 MCP 服务器
哈希拉 MCP 服务器用于与哈希拉网络进行交互，它基于 Model Context Protocol (MCP) 构建。该服务器具备创建哈希拉钱包、查询账户余额、构建交易以及发送签名交易等功能。
🚀 快速开始
先决条件
- Node.js（版本 v18 或更高）
- npm 或 yarn
- 一个哈希拉账户（可用于测试网或主网）
安装步骤
-
克隆此仓库：
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
编译应用程序
编译 TypeScript 代码：
npm run build
对于开发环境下的自动重新编译：
npm run dev
启动服务器
启动服务器：
npm start
服务器将在 http://localhost:3000（或您指定的端口）上运行。
使用测试客户端进行测试
此仓库包含一个测试客户端脚本，演示如何连接到 MCP 服务器并使用其工具。该客户端提供完整的端到端流程，展示所有可用功能。
运行测试客户端：
node test-client.js
测试客户端将执行以下步骤：
- 连接到 MCP 服务器
- 列出所有可用工具
- 创建一个新的哈希拉钱包（create - wallet 工具）
- 检查新账户的余额（check - balance 工具）
- 构建一个向操作员账户转移账户全部余额的交易（build - transaction 工具）
- 使用哈希拉 SDK 在客户端签名事务
- 提交签名的事务到哈希拉网络（send - transaction 工具）
- 显示事务结果
这展示了通过 MCP 服务器与哈希拉网络交互的完整生命周期，从账户创建到事务提交。
✨ 主要特性
MCP 服务器的主要目的是展示如何通过 MCP 服务器完全处理交易构建和提交，客户端仅需验证交易。具体来说：
- 交易构建完全在 MCP 服务器上完成
- 客户端对生成的交易进行签名
- MCP 服务器负责将交易提交到哈希拉网络
- 这种架构允许集中化交易逻辑并降低客户端复杂性
⚠️ 重要提示
这是一个演示实现，不适合在生产环境中使用。当前实现存在多个安全漏洞：
- 私钥以明文形式返回到响应体中
- 敏感数据未加密
- 无事务验证机制
此实现旨在演示 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 工具
服务器提供的工具如下：
- create - wallet：创建一个新的哈希拉账户，并设置最小初始余额。
- check - balance：检查指定账户的当前余额。
- build - transaction：构建一个事务，用于从指定账户转移资金到目标地址。
- send - transaction：提交签名的事务到哈希拉网络。
每个工具都有特定的输入和输出格式，请参阅相关文档以获取详细信息。
部署
要部署服务器，请运行以下命令：
npm install
然后启动服务器：
npm start
确保您已经配置好了 .env 文件，并且所有依赖项均已安装。