ヘデラMCPサーバー

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

⚠️ セキュリティ警告

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

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

Related MCP server: Foundry MCP Project

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

このリポジトリをクローンします:
git clone https://github.com/hedera-dev/hedera-mcp-server.git cd hedera-mcp-server
依存関係をインストールします:
npm install
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

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

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

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

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