Bridge Metrics MCP

🚀 Bridge Metrics MCP

Bridge Metrics MCPは、リアルタイムのクロスチェーンブリッジメトリクスを提供するMCPサーバーです。AIエージェントがブロックチェーンネットワーク間の流動性、トランザクションフロー、およびパフォーマンスを分析できるようにします。

✨ 主な機能

• チェーンの一覧表示: DeFiLlamaからすべてのチェーンのスラッグのリストを取得し、総ロック価値（TVL）の降順でソートします。
• ブリッジの一覧表示: すべてのブリッジを取得し、必要に応じてチェーンの内訳を含め、24時間の取引量でソートします。
• 過去の取引量: ブリッジまたはチェーンの過去の取引量データを取得します。日付は YYYY-MM-DD HH:MM:SS 形式です。
• トークンの日次統計: 24時間のトークン取引量の内訳を取得します。トークンID、シンボル、小数点以下の桁数、預入/引き出し額、およびUSD価値が含まれ、預入のUSD価値でソートされます。
• ブリッジトランザクション: 特定のブリッジのトランザクションの概要を取得します。トランザクションハッシュ、タイムスタンプ、およびUSD価値などの詳細が含まれます。
• プロンプト: ブリッジの取引量を分析し、週間取引量などの指標に基づいてブリッジを比較するためのサンプルプロンプトが含まれています。

📦 インストール

前提条件

• Python: バージョン3.10以上。
• uv: Pythonのパッケージおよび仮想環境マネージャー（依存関係の管理に推奨）。

インストール手順

1. リポジトリのクローン:

   git clone https://github.com/kukapay/bridge-metrics-mcp.git
   cd bridge-metrics-mcp
   

2. 依存関係のインストール:

   uv sync
   

3. Claude Desktopへのインストール:

   サーバーをClaude Desktopアプリケーションとしてインストールします。

   uv run mcp install main.py --name "Bridge Metrics"
   

   参考としての設定ファイル:

   {
      "mcpServers": {
          "Bridge Metrics": {
              "command": "uv",
              "args": [ "--directory", "/path/to/bridge-metrics-mcp", "run", "main.py" ]
          }
      }
   }
   

   /path/to/bridge-metrics-mcp を実際のインストールパスに置き換えてください。

💻 使用例

ツールと使用方法

このサーバーは、JSON-RPCまたは互換性のあるクライアントでの自然言語プロンプトを通じてアクセスできる以下のツールを提供します。

1. list_chains:

   • 説明: DeFiLlamaで利用可能なすべてのチェーンのスラッグをリストし、TVLでソートします。
   • パラメータ: なし。
   • 出力: Name、Gecko ID、Token Symbol、Chain ID、TVL の列を持つ表。

2. list_bridges:

   • 説明: すべてのブリッジを、24時間の取引量でソートしてリストし、必要に応じてチェーンの内訳を含めます。
   • パラメータ: include_chains（ブール値、デフォルトは False）。
   • 出力: ID、Name、Display Name、Last 24h Volume、Chains の列を持つ表。

3. get_historical_volumes:

   • 説明: チェーンまたはブリッジの過去の取引量を取得します。日付は YYYY-MM-DD HH:MM:SS 形式です。
   • パラメータ: chain（文字列、必須）、bridge_id（整数、オプション）。
   • 出力: Date、Deposit USD、Withdraw USD、Deposit Txs、Withdraw Txs の列を持つ表。

4. get_day_stats:

   • 説明: 24時間のトークン取引量の内訳を取得し、預入のUSD価値でソートします。
   • パラメータ: timestamp（整数、必須）、chain（文字列、必須）、bridge_id（整数、オプション）。
   • 出力: Token ID、Symbol、Decimals、Deposit Amount、Deposit USD Value、Withdraw Amount、Withdraw USD Value の列を持つ表。

5. get_transactions:

   • 説明: ブリッジのトランザクションの概要を取得し、タイムスタンプでソートします。
   • パラメータ: bridge_id（整数、必須）、start_timestamp、end_timestamp、source_chain、address、limit（すべてオプション）。
   • 出力: Tx Hash、Timestamp、Block、From、To、Token、Amount、Type、Chain、Bridge Name、USD Value の列を持つ表。

6. プロンプト:

   • analyze_bridge_volume: 特定のブリッジの取引量データを分析します。
   • compare_bridges: 指定された指標（例: weeklyVolume）に基づいて2つのブリッジを比較します。

対話例

以下は、互換性のあるMCPクライアントで自然言語プロンプトを使用した対話例と、期待される結果です。

例1: すべてのチェーンのリスト表示

プロンプト:

List all chains available on DeFiLlama.

呼び出されるツール: list_chains

結果:

+----------------+-------------+---------------+-----------+-------------+
| Name           | Gecko ID    | Token Symbol  | Chain ID  | TVL         |
+================+=============+===============+===========+=============+
| Ethereum       | ethereum    | ETH           | 1         | 50000000000 |
| Binance Smart  | binance-smart-chain | BNB   | 56        | 15000000000 |
| Polygon        | polygon     | MATIC         | 137       | 5000000000  |
+----------------+-------------+---------------+-----------+-------------+

例2: チェーンを含むブリッジのリスト表示

プロンプト:

Show all bridges with their supported chains, sorted by 24-hour volume.

呼び出されるツール: list_bridges(include_chains=True)

結果:

+----+-------------+---------------+-----------------+----------------------------------+
| ID | Name        | Display Name  | Last 24h Volume | Chains                           |
+====+=============+===============+=================+==================================+
| 1  | polygon     | Polygon       | 1000000         | Ethereum, Polygon, Binance Smart |
| 2  | optimism    | Optimism      | 750000          | Ethereum, Optimism               |
| 3  | arbitrum    | Arbitrum      | 500000          | Ethereum, Arbitrum               |
+----+-------------+---------------+-----------------+----------------------------------+

例3: チェーンの過去の取引量

プロンプト:

Get historical volumes for the Ethereum chain.

呼び出されるツール: get_historical_volumes(chain="ethereum")

結果:

+---------------------+---------------+---------------+---------------+---------------+
| Date                | Deposit USD   | Withdraw USD  | Deposit Txs   | Withdraw Txs  |
+=====================+===============+===============+===============+===============+
| 2025-09-12 00:00:00 | 1000000.0     | 500000.0      | 150           | 100           |
| 2025-09-11 00:00:00 | 1200000.0     | 600000.0      | 180           | 120           |
| 2025-09-10 00:00:00 | 900000.0      | 450000.0      | 130           | 90            |
+---------------------+---------------+---------------+---------------+---------------+

例4: ブリッジのトークンの日次統計

プロンプト:

Show the 24-hour token stats for bridge ID 1 on Ethereum for September 12, 2025.

呼び出されるツール: get_day_stats(timestamp=1752499200, chain="ethereum", bridge_id=1)

結果:

+----------------+--------+----------+------------------+-------------------+------------------+-------------------+
| Token ID       | Symbol | Decimals | Deposit Amount   | Deposit USD Value | Withdraw Amount  | Withdraw USD Value|
+================+========+==========+==================+===================+==================+===================+
| 0xa0b869...    | USDC   | 6        | 2000000          | 2000000.0         | 0                | 0.0               |
| 0xc02aaa...    | ETH    | 18       | 1000000000000000 | 1500000.0         | 500000000000000  | 750000.0          |
| 0xdac17f...    | DAI    | 18       | 0                | 0.0               | 1000000000000000 | 1000000.0         |
+----------------+--------+----------+------------------+-------------------+------------------+-------------------+

例5: ブリッジの取引量の分析

プロンプト:

Analyze the volume data for the Polygon bridge using historical volumes.

呼び出されるツール: get_historical_volumes(chain="polygon", bridge_id=1) の後に analyze_bridge_volume

結果:

Analyze the following volume data for the bridge 'Polygon':

+---------------------+---------------+---------------+---------------+---------------+
| Date                | Deposit USD   | Withdraw USD  | Deposit Txs   | Withdraw Txs  |
+=====================+===============+===============+===============+===============+
| 2025-09-12 00:00:00 | 800000.0      | 400000.0      | 120           | 80            |
| 2025-09-11 00:00:00 | 900000.0      | 450000.0      | 140           | 90            |
| 2025-09-10 00:00:00 | 700000.0      | 350000.0      | 100           | 70            |
+---------------------+---------------+---------------+---------------+---------------+

Key insights:
- The Polygon bridge shows consistent deposit and withdrawal activity over the past three days.
- Deposits are roughly double the withdrawals in USD value, indicating higher inflow than outflow.
- Transaction counts are stable, with deposits averaging 120 transactions per day.

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。