ヘデラ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. Hedera の資格情報を使用して、ルート ディレクトリに.envファイルを作成します。
   HEDERA_OPERATOR_ID=your-operator-account-id HEDERA_OPERATOR_KEY=your-operator-private-key HEDERA_NETWORK=testnet # or mainnet PORT=3000 # optional, defaults to 3000

アプリケーションの構築

TypeScript コードをコンパイルします。

自動再コンパイルによる開発の場合:

サーバーの実行

サーバーを起動します。

サーバーはhttp://localhost:3000 (または .env ファイルで指定されたポート) で利用できます。

テストクライアントによるテスト

リポジトリには、MCPサーバーに接続してツールを使用する方法を示すテストクライアントスクリプトが含まれています。このクライアントは、利用可能なすべてのツールをデモンストレーションする完全なエンドツーエンドのフローを提供します。

テストクライアントを実行します。

テスト クライアントは次のことを実行します。

1. MCPサーバーに接続する
2. 利用可能なツールの一覧
3. 新しいHederaウォレットを作成する（create-walletツール）
4. 新しいアカウントの残高を確認する（残高確認ツール）
5. アカウントの残高全体をオペレーターアカウントに転送するトランザクションを構築する（トランザクション構築ツール）
6. Hedera SDKを使用してクライアント側でトランザクションに署名する
7. 署名されたトランザクションをHederaネットワークに送信する（トランザクション送信ツール）
8. 取引結果を表示する

これは、アカウントの作成からトランザクションの送信まで、MCP サーバーを介して Hedera ネットワークと対話する完全なライフサイクルを示しています。

利用可能なMCPツール

サーバーは次のツールを提供します。

1. create-wallet : 最小限の初期残高で新しいHederaアカウントを作成します
   • 入力パラメータは不要
   • アカウントID、公開鍵、秘密鍵を返します
2. check-balance : Hederaアカウントの残高をチェックする
   • 入力: accountId (文字列)
   • 口座残高をtinybarsで返します
3. build-transaction : 転送トランザクションを構築する（署名なし）
   • 入力:
     • senderAccountId (文字列)
     • recipientAccountId （文字列）
     • amount （数値、タイニーバー単位）
   • base64でエンコードされたトランザクションを返します
4. send-transaction : 署名されたトランザクションをHederaネットワークに送信する
   • 入力: signedTransaction (文字列、base64エンコード)
   • トランザクションのステータスとIDを返します

展開

簡単なデプロイメント スクリプトが含まれています:

まず実行可能にしてください: