Hedera MCP

本地服务

hedera-mcp.vercel.app金融数据079 周前更新

代码仓库访问官网

关于 Hedera MCP

Hedera MCP 是基于 Hedera Agent Kit 构建的 Hedera 区块链服务，供 AI 助手通过 MCP 执行账户、代币和分发操作，并采用非托管设置。

主要功能

01账户余额操作
02查询代币余额与持有者
03创建和铸造同质化代币及 NFT
04代币转账与空投
05非托管密钥处理

适用场景

01查看 HBAR 和代币余额
02创建或铸造 Hedera 代币
03分发代币或领取空投

MCP 相关

它向 MCP 客户端提供 16 种工具，涵盖账户查询、代币创建和转账。项目列出 Claude Desktop 为兼容客户端。

#mcp #blockchain #claude #hedera #ai-agent #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "hedera": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-mcp"
      ]
    }
  }
}

启动命令npx -y hedera-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmhedera-mcpstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Hedera MCP

NPM 版本

Hedera MCP 是一个基于 Hedera Agent Kit 构建的 Hedera 区块链 MCP 服务实现。它让支持 Model Context Protocol（MCP）的 AI 模型能够与 Hedera 网络交互，因此你无需编写代码或了解技术细节，就能执行各种区块链操作。

功能

提供 15+ 个 MCP 工具，涵盖账户操作、代币操作和分发。
非托管式设置，不会在任何服务上暴露私钥。
支持 Claude Desktop 等兼容 MCP 的客户端。还有更多客户端正在开发中。
与 filesystem、github 等其他 MCP 工具配合使用时会更加强大，让 AI 能够访问你的目录，并在 Web3 内外自动执行任务。

在 Claude Desktop 中使用

如果尚未安装，请先安装 Claude Desktop
打开 Claude Desktop 设置
将 Hedera MCP 服务添加到配置中：

{
  "mcpServers": {
    "hedera": {
      "command": "npx",
      "args": [
        "-y",
        "hedera-mcp",
        "--hedera_account_id=0.0.XXXXX",
        "--hedera_private_key=YOUR_PRIVATE_KEY",
        "--hedera_network=testnet"
      ],
      "disabled": false
    }
  }
}

将 0.0.XXXXX 替换为你的实际 Hedera 账户 ID，并将 YOUR_PRIVATE_KEY 替换为你的实际私钥。网络参数可以使用 testnet 或 mainnet。

你也可以通过以下方式独立运行：

npx hedera-mcp

背景

如今，大多数 Web3 Agent Kit 都基于 Langchain，要求开发者创建独立应用。然而，AI 模型发展迅速，开发者发布应用后，模型往往很快就会过时或淘汰，导致应用在短短几个月内就停止维护。

Claude AI 于 2024 年末推出 Model Context Protocol（MCP），如今已迅速普及。它通过直接集成到 AI 界面中解决了这一问题，让用户能够轻松切换到最新模型，并通过标准化工具与 Web3 交互。

可用工具

Hedera MCP 服务向 Claude 和其他 AI 助手提供以下工具：

hedera_get_hbar_balance - 获取账户的 HBAR 余额
hedera_get_all_token_balances - 获取账户的所有代币余额
hedera_get_hts_balance - 获取账户中特定代币的余额
hedera_get_token_holders - 获取特定代币的持有者
hedera_airdrop_token - 向多个账户空投代币
hedera_associate_token - 将代币与账户关联
hedera_claim_airdrop - 领取空投中的代币
hedera_create_fungible_token - 创建新的同质化代币
hedera_create_non_fungible_token - 创建新的非同质化代币
hedera_dissociate_token - 解除代币与账户的关联
hedera_get_pending_airdrop - 获取账户待领取的空投
hedera_mint_fungible_token - 铸造更多同质化代币
hedera_mint_nft - 铸造新的非同质化代币
hedera_reject_token - 拒绝发送到账户的代币
hedera_transfer_native_hbar_token - 向其他账户转账 HBAR
hedera_transfer_token - 向其他账户转账代币

截图

2025-04-27 22-59-42 的截图

故障排除

如果遇到问题：

确认账户 ID 和私钥正确
检查账户是否有足够的 HBAR 余额
确保网络选择（testnet/mainnet）正确
更改 MCP 配置后，重启 Claude Desktop
查看控制台输出中的详细错误信息

部署

Hedera 测试网

组件名称	Hashscan 链接
由 MCP 部署的同质化代币	https://hashscan.io/testnet/token/0.0.5915836
由 MCP 执行的转账交易	https://hashscan.io/testnet/transaction/1745803371.170539683