Hedera Dev Mirrornode MCP Server

🚀 テストネットミラーノード MCP サーバー（Hedera）

このリポジトリには、Hedera Testnet Mirror Node API インターフェースとやり取りする Model Context Protocol (MCP) サーバーが含まれています。このサーバーは、MCP サーバーを作成するための TypeScript フレームワークである FastMCP を使用し、入力検証に Zod スキームを利用しています。

✨ 主な機能

• エンドポイント統合：Hedera Mirror Node の API（OpenAPI 仕様形式で定義）を自動的に MCP 互換のツールに変換します。
• サーバー送信イベント (SSE) サポート：クライアントはこの MCP サーバーを通じて SSE トランスポート接続を使用できません。
• スキーマ検証：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 サーバー已启动

サーバーは、構成された SSE エンドポイントを通じてアクセスできます。 http://localhost:3333/hedera-testnet-mirror-node-api/sse

📚 ドキュメント

プロジェクト構造

• mcpServer.ts：MCP サーバーを初期化して起動するためのエントリーファイルです。
• openApiZod.ts：Mirror Node API エンドポイント定義と zodios（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) サーバーの初期化 SSE トランスポートを使用して MCP サーバーを起動します。

🔧 技術詳細

依存関係

• FastMCP：MCP サーバーを構築するためのフレームワークです。
• Zod：TypeScript の事前スキーマ宣言と検証に使用されるライブラリです。
• openapi-zod-client：OpenAPI 仕様ファイルから Zodios コードを生成します。

作者

Brendan Graetz

ライセンス

MIT