Bridge Metrics MCP

🚀 Bridge Metrics MCP

Bridge Metrics MCP 是一個 MCP 服務器，它能提供實時的跨鏈橋接指標，讓 AI 代理可以分析不同區塊鏈網絡間的流動性、交易流量和性能表現。

✨ 主要特性

• 列出鏈信息：從 DeFiLlama 獲取所有鏈的縮寫列表，並按總鎖倉價值（TVL）降序排列。
• 列出橋接信息：獲取所有橋接信息，可選擇包含鏈的細分信息，按 24 小時交易量排序。
• 歷史交易量：獲取某個橋接或鏈的歷史交易量數據，日期格式為 YYYY-MM-DD HH:MM:SS。
• 每日代幣統計：獲取 24 小時代幣交易量細分信息，包括代幣 ID、符號、小數位數、存入/提取金額和美元價值，按存入美元價值排序。
• 橋接交易：獲取特定橋接的交易摘要，包含交易哈希、時間戳和美元價值等詳細信息。
• 提示信息：包含用於分析橋接交易量和基於每週交易量等指標比較橋接的示例提示。

📦 安裝指南

前提條件

• 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 排序。
   • 參數：無。
   • 輸出：包含 名稱、Gecko ID、代幣符號、鏈 ID、TVL 列的表格。

2. list_bridges：

   • 描述：列出所有橋接，按 24 小時交易量排序，可選擇包含鏈信息。
   • 參數：include_chains（布爾值，默認 False）。
   • 輸出：包含 ID、名稱、顯示名稱、過去 24 小時交易量、鏈 列的表格。

3. get_historical_volumes：

   • 描述：獲取某個鏈或橋接的歷史交易量，日期格式為 YYYY-MM-DD HH:MM:SS。
   • 參數：chain（字符串，必填），bridge_id（整數，可選）。
   • 輸出：包含 日期、存入美元、提取美元、存入交易數、提取交易數 列的表格。

4. get_day_stats：

   • 描述：獲取 24 小時代幣交易量細分信息，按存入美元價值排序。
   • 參數：timestamp（整數，必填），chain（字符串，必填），bridge_id（整數，可選）。
   • 輸出：包含 代幣 ID、符號、小數位數、存入金額、存入美元價值、提取金額、提取美元價值 列的表格。

5. get_transactions：

   • 描述：獲取某個橋接的交易摘要，按時間戳排序。
   • 參數：bridge_id（整數，必填），start_timestamp、end_timestamp、source_chain、address、limit（均為可選）。
   • 輸出：包含 交易哈希、時間戳、區塊、發送方、接收方、代幣、金額、類型、鏈、橋接名稱、美元價值 列的表格。

6. 提示信息：

   • analyze_bridge_volume：分析特定橋接的交易量數據。
   • compare_bridges：根據指定指標（如 weeklyVolume）比較兩個橋接。

示例交互

以下是在兼容的 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 文件。