Hedera Dev Hedera MCP Server

🚀 乙太坊 MCP サーバー

このサーバーは、Hedera ネットワークとの相互作用を可能にするモデルコンテキストプロトコル (MCP) サーバーです。Hedera ウォレットの作成、アカウント残高の確認、トランザクションの構築、署名付きトランザクションの送信などのツールを提供します。

🚀 クイックスタート

このガイドでは、乙太坊 MCP サーバーのセットアップ、実行、およびテストに必要な手順を説明します。

✨ 主な機能

• Hedera ウォレットの作成
• アカウント残高の確認
• トランザクションの構築
• 署名付きトランザクションの送信

📦 インストール

前提条件

• Node.js（v18 以上）
• npm または yarn
• Hedera アカウント（テストネットまたはメインネット用）

インストール手順

1. このリポジトリをクローンします：

git clone https://github.com/hedera-dev/hedera-mcp-server.git
cd hedera-mcp-server

2. 依存関係をインストールします：

npm install

3. ルートディレクトリに .env ファイルを作成し、Hedera の認証情報を記述します：

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. 新しい Hedera アカウントを作成します（create-wallet ツール）。
4. 新しいアカウントの残高を確認します（check-balance ツール）。
5. オペレーターアカウントに全残高を移転するトランザクションを構築します（build-transaction ツール）。
6. Hedera SDK を使用してクライアントでトランザクションに署名します。
7. 署名付きトランザクションを Hedera ネットワークに送信します（send-transaction ツール）。
8. トランザクション結果を表示します。

これにより、MCP サーバーを介した Hedera ネットワークとの相互作用の完全なライフサイクルが示されます。

利用可能な MCP ツール

サーバーは以下のツールを提供します：

1. create-wallet：新しい Hedera アカウントを作成します（最小初期残高付き）

   • 入力パラメーター：なし
   • 返り値：アカウント ID、公開鍵、秘密鍵

2. check-balance：Hedera アカウントの残高を確認します

   • 入力：accountId（文字列）
   • 返り値：tinybars 単位のアカウント残高

3. build-transaction：未署名の転送トランザクションを構築します

   • 入力：
     • senderAccountId（文字列）
     • recipientAccountId（文字列）
     • amount（数字、tinybars 単位）
   • 返り値：base64 エンコードされたトランザクション内容

4. send-transaction：署名付きトランザクションを Hedera ネットワークに送信します

   • 入力：signedTransaction（文字列、base64 エンコード）
   • 返り値：トランザクションの状態と結果

📚 ドキュメント

デプロイ

デプロイスクリプトを実行します：

chmod +x deploy.sh
./deploy.sh

このスクリプトは、MCP サーバーを起動します。