Hedera MCP

Name: Hedera MCP
Author: pisuthd

@pisuthd

代码仓库主页

关于 Hedera MCP

MCP server implementation for the Hedera blockchain using the Hedera Agent Kit.

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

基本信息

分类

其他

运行时

node

传输方式

stdio

发布者

pisuthd

配置

使用下面的配置,将此服务器添加到你的 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
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Hedera MCP?

Hedera MCP is a Model Context Protocol (MCP) server implementation for the Hedera blockchain, built using the Hedera Agent Kit. It allows AI models that support MCP to interact with the Hedera network and perform a wide range of blockchain operations without needing to write code.

How to use Hedera MCP?

Hedera MCP works with MCP‑compatible clients like Claude Desktop. Add it to your Claude Desktop configuration with a command like npx -y hedera-mcp --hedera_account_id=0.0.XXXXX --hedera_private_key=YOUR_PRIVATE_KEY --hedera_network=testnet. You can also run it standalone with npx hedera-mcp.

Key features of Hedera MCP

15+ MCP tools covering account, token, and distribution operations
Non‑custodial setup (no private keys exposed on any server)
Compatible with MCP clients like Claude Desktop
Enables AI to automate tasks both within and outside Web3
Simple configuration and standalone execution

Use cases of Hedera MCP

Retrieve HBAR or token balances for any Hedera account
Create and mint fungible or non‑fungible tokens (NFTs)
Transfer HBAR or tokens between accounts
Manage token associations, dissociations, and rejections
Create and claim token airdrops to multiple accounts

FAQ from Hedera MCP

How do I set up Hedera MCP with Claude Desktop?

Add a hedera entry in your Claude Desktop MCP configuration with the npx command and your Hedera account ID, private key, and network (testnet or mainnet). Restart Claude Desktop after changing the configuration.

What dependencies or runtime are required?

Hedera MCP runs via npx (Node.js) and requires no additional installation. Your Hedera account must have sufficient HBAR balance for transactions.

Where does my private key and account data live?

The setup is non‑custodial: your private key is passed only as a command‑line argument to the local MCP server; it is never exposed on a remote server. All data operations occur on the Hedera blockchain.

What transports or authentication does the server use?

Hedera MCP connects to Claude Desktop via the standard MCP stdio transport. Authentication to the Hedera network is done using the provided account ID and private key.

What should I do if I encounter errors?

Verify your account ID and private key are correct, confirm your account has sufficient HBAR, ensure the network parameter (testnet/mainnet) is correct, and restart Claude Desktop after configuration changes. Check console output for detailed error messages.