ヘデラMCPサーバー

Hederaネットワークとやり取りするためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、Hederaウォレットの作成、アカウント残高の確認、トランザクションの構築、署名付きトランザクションの送信のためのツールを提供します。

⚠️ セキュリティ警告

**これはデモ実装であり、本番環境では使用しないでください。**現在の実装には、いくつかのセキュリティ上の脆弱性があります。

• 秘密鍵はレスポンス本文で送信される

• 機密データの暗号化なし

• 取引検証メカニズムがない

この実装は MCP の概念を示すことを目的としており、実稼働環境で使用する前に適切に保護する必要があります。

Related MCP server: MCP Clusters API Server

主な目的

このMCPサーバーの主な目的は、クライアントはトランザクションの検証のみで、トランザクションの構築と実行がMCPサーバーによって処理される様子を示すことです。具体的には以下のとおりです。

1. トランザクションの構築はMCPサーバー上で完全に行われる

2. クライアントは構築されたトランザクションに署名する

3. MCPサーバーはHederaネットワークへのトランザクションの送信を処理する。

4. このアーキテクチャにより、集中化されたトランザクションロジックが可能になり、クライアント側の複雑さが軽減されます。

前提条件

• 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 コードをコンパイルします。

npm run build

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

npm run dev

サーバーの実行

サーバーを起動します。

npm start

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

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

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

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

node test-client.js

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

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を返します

展開

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

./deploy.sh

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

chmod +x deploy.sh