Hedera MCP

Hedera MCP

Hedera MCP は、Hedera Agent Kit を使用して構築された、Hedera ブロックチェーン向けの MCP サーバー実装です。Model Context Protocol（MCP）をサポートする AI モデルが Hedera ネットワークとやり取りできるようになり、コードを書いたり技術的な詳細を理解したりすることなく、幅広いブロックチェーン操作を実行できます。

• YouTube デモ
• ランディングページ
• NPM レジストリ

機能

• アカウント操作、トークン操作、配布に対応した 15 個以上の MCP ツール。

• サーバー上に秘密鍵を公開しない、非カストディアルなセットアップです。

• Claude Desktop など、MCP 互換クライアントをサポートしています。さらに多くのクライアントが開発中です。

• filesystem や github などの他の MCP ツールと組み合わせることで、より強力になります。AI がディレクトリにアクセスし、Web3 の内外でタスクを自動化できるようになります。

Claude Desktop での使用

1. まだインストールしていない場合は、Claude Desktop をインストールします
2. Claude Desktop の設定を開きます
3. 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 アシスタントに以下のツールを提供します。

1. hedera_get_hbar_balance - アカウントの HBAR 残高を取得します
2. hedera_get_all_token_balances - アカウントのすべてのトークン残高を取得します
3. hedera_get_hts_balance - アカウントの特定のトークンの残高を取得します
4. hedera_get_token_holders - 特定のトークンの保有者を取得します
5. hedera_airdrop_token - 複数のアカウントへのトークンのエアドロップを作成します
6. hedera_associate_token - アカウントにトークンを関連付けます
7. hedera_claim_airdrop - エアドロップからトークンを受け取ります
8. hedera_create_fungible_token - 新しい代替可能トークンを作成します
9. hedera_create_non_fungible_token - 新しい非代替性トークンを作成します
10. hedera_dissociate_token - アカウントからトークンの関連付けを解除します
11. hedera_get_pending_airdrop - アカウントの保留中のエアドロップを取得します
12. hedera_mint_fungible_token - 代替可能トークンを追加で発行します
13. hedera_mint_nft - 新しい非代替性トークンを発行します
14. hedera_reject_token - アカウントに送られたトークンを拒否します
15. hedera_transfer_native_hbar_token - 別のアカウントに HBAR を送金します
16. hedera_transfer_token - 別のアカウントにトークンを送金します

スクリーンショット

トラブルシューティング

問題が発生した場合は、以下を確認してください。

• アカウント ID と秘密鍵が正しいことを確認します
• アカウントに十分な HBAR 残高があることを確認します
• ネットワークの選択（testnet/mainnet）が正しいことを確認します
• MCP の設定を変更した後、Claude Desktop を再起動します
• 詳細なエラーメッセージについては、コンソール出力を確認します

デプロイ

Hedera Testnet

コンポーネント名	Hashscan へのリンク
MCP によってデプロイされた代替可能トークン	https://hashscan.io/testnet/token/0.0.5915836
MCP による送金トランザクション	https://hashscan.io/testnet/transaction/1745803371.170539683

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。