Mirrornode MCP Server

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

このリポジトリには、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