Hedera Testnet Mirror Node MCP Server

Hedera Testnet Mirror Node MCP サーバー

このリポジトリには、Hedera Testnet Mirror Node API と連携する Model Context Protocol（MCP）サーバーが含まれています。 このサーバーは、MCP サーバーを作成するための TypeScript フレームワークである FastMCP を使用して構築されています。 入力の検証には Zod スキーマを使用します。

機能

• エンドポイント連携：OpenAPI 仕様形式で定義された Hedera Mirror Node API を、MCP 互換のツールに自動変換します。
• Server-Sent Events（SSE）サポート：クライアントは SSE トランスポート経由でこの MCP サーバーに接続できません。
• スキーマ検証：Zod を使用して、リクエストパラメーターが定義済みのスキーマに準拠していることを確認します。

前提条件

サーバーを実行する前に、以下がインストールされていることを確認してください。

• Bun、または TypeScript を直接実行できるその他の環境。

インストール

(1) リポジトリをクローンします

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

(2) プロジェクトディレクトリに移動します

cd mirrornode-mcp-server

(3) 依存関係をインストールします

npm install

使用方法

MCP サーバーを起動するには：

bun mcpServer.ts

起動に成功すると、以下が表示されます。

MCP server started

サーバーには、設定された SSE エンドポイントからアクセスできます。

http://localhost:3333/hedera-testnet-mirror-node-api/sse

プロジェクト構成

• mcpServer.ts：MCP サーバーを初期化して起動するエントリーポイントです。
• openApiZod.ts：Mirror Node API のエンドポイント定義と、zodios（zod スキーマ定義を追加した axios のようなもの）を使用する API クライアントが含まれています。
  • このファイルは、openapi-zod-client を使用してプログラムで生成された後、一部手動で変更されています。

仕組み

(1) API クライアントの作成

createApiClient 関数を使用して、Hedera Testnet Mirror Node 用の API クライアントを作成します。 MCP サーバーは、この HTTP API クライアントと独自の SSE トランスポートとの間でプロキシとして機能します。

(2) エンドポイントの変換：

endpointDefinitions 内の各エンドポイント定義を convertZodiosToMcp 関数で処理し、以下を行います。

• エンドポイントが GET メソッドを使用していることを検証します。
• パラメーターを Zod スキーマに対応付けます。
• 該当する API 呼び出しを行い、結果を返す実行関数を定義します。
• MCP サーバーにツールを登録します。

(3) サーバーの初期化：

MCP サーバーは SSE トランスポートで起動します。

依存関係

• FastMCP：MCP サーバーを構築するためのフレームワークです。
• Zod：TypeScript を第一に考えたスキーマ宣言および検証ライブラリです。
• openapi-zod-client：OpenAPI 仕様ファイルから Zodios コードを生成します。

作者

Brendan Graetz

ライセンス

MIT