Ethereum Validator Queue MCP

🚀 以太坊驗證器隊列MCP

以太坊驗證器隊列MCP是一個MCP服務器，可即時跟蹤以太坊驗證器的激活和退出隊列，使AI智能體能夠監控質押動態和網絡參與趨勢。

✨ 主要特性

• 工具：
  • get_activation_queue：獲取以太坊驗證器激活隊列的統計信息，包括隊列長度、活躍驗證器總數、即將加入的驗證器餘額以及預計等待時間。
  • get_exit_queue：獲取以太坊驗證器退出隊列的統計信息，包括隊列長度、活躍驗證器總數、即將退出的驗證器餘額以及預計等待時間。
  • get_validator_status：通過驗證器的公鑰查詢特定驗證器的狀態，提供狀態、有效餘額、激活時期和退出時期等詳細信息。
• 提示模板：
  • analyze_queue：一個可重複使用的大語言模型提示模板，用於分析驗證器隊列趨勢，包括質押需求、對ETH價格的影響以及網絡安全性。

📦 安裝指南

前提條件

• Python：版本3.10或更高
• uv：一個快速且現代的Python包管理器（安裝說明）

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/kukapay/ethereum-validator-queue-mcp.git
   cd ethereum-validator-queue-mcp
   

2. 安裝依賴項：

   uv sync
   

3. 安裝到Claude桌面應用：

   將服務器作為Claude桌面應用程序進行安裝：

   uv run mcp install main.py --name "Ethereum Validator Queue"
   

   參考配置文件如下：

   {
      "mcpServers": {
          "Ethereum Validator Queue": {
              "command": "uv",
              "args": [ "--directory", "/path/to/ethereum-validator-queue-mcp", "run", "main.py" ]
          }
      }
   }
   

   請將/path/to/ethereum-validator-queue-mcp替換為你實際的安裝路徑。

💻 使用示例

工具和提示模板的使用

• 工具：

  • get_activation_queue()：返回激活隊列的統計信息，例如："當前激活隊列長度：7189個驗證器，活躍驗證器總數：1084363個，即將加入的驗證器餘額：283043.84 ETH，預計等待時間：約8.0天。"
  • get_exit_queue()：返回退出隊列的統計信息，例如："當前退出隊列長度：27152個驗證器，活躍驗證器總數：1084363個，即將退出的驗證器餘額：882528.00 ETH，預計等待時間：約30.2天。"
  • get_validator_status(pubkey)：返回給定公鑰（以'0x'開頭的48字節十六進制字符串）對應的驗證器詳細信息，例如："驗證器0x1234...：狀態：活躍在線，有效餘額：32.00 ETH，激活時期：123456，退出時期：無。"

• 提示模板：

  • analyze_queue()：生成一個用於大語言模型分析隊列趨勢的提示，例如："分析當前以太坊驗證器隊列：當前隊列長度對質押需求有何指示？這可能如何影響ETH價格和網絡安全？如有可能，請提供歷史背景信息。"

交互示例

以下是在兼容MCP的客戶端（例如Claude桌面應用）中可能使用的自然語言提示示例，以及服務器根據示例數據給出的相應輸出。

1. 獲取激活隊列統計信息：

   • 提示："顯示當前以太坊驗證器激活隊列的狀態。"
   • 命令：get_activation_queue()
   • 輸出：

     當前激活隊列長度：7189個驗證器
     活躍驗證器總數：1084363個
     即將加入的驗證器餘額：283043.84 ETH
     預計等待時間：約8.0天（假設每天約激活900個驗證器）
     

2. 獲取退出隊列統計信息：

   • 提示："以太坊驗證器退出隊列的狀態如何？"
   • 命令：get_exit_queue()
   • 輸出：

     當前退出隊列長度：27152個驗證器
     活躍驗證器總數：1084363個
     即將退出的驗證器餘額：882528.00 ETH
     預計等待時間：約30.2天（假設每天約退出900個驗證器）
     

3. 獲取驗證器狀態：

   • 提示："檢查公鑰為0x93247f2f...的驗證器的狀態。"
   • 命令：get_validator_status("0x93247f2f...")
   • 輸出（假設來自API的示例數據）：

     驗證器0x93247f2f...：
     狀態：活躍在線
     有效餘額：32.00 ETH
     激活時期：123456
     退出時期：無
     

4. 分析隊列趨勢：

   • 提示："分析當前以太坊驗證器隊列的趨勢。"
   • 命令：analyze_queue()
   • 輸出（發送給大語言模型進行分析的提示）：

     分析當前以太坊驗證器隊列：
     - 當前隊列長度對質押需求有何指示？
     - 這可能如何影響ETH價格和網絡安全？
     - 如有可能，請提供歷史背景信息。
     

     • 大語言模型響應（示例，取決於大語言模型）：

       當前以太坊驗證器隊列顯示，退出隊列（27152個驗證器）明顯長於激活隊列（7189個驗證器），這表明退出的驗證器數量多於加入的驗證器數量。這可能意味著質押需求下降，可能是由於市場條件或盈利問題。大量的退出餘額（882528 ETH）可能會增加ETH的拋售壓力，短期內可能對其價格產生負面影響。然而，由於有超過100萬個活躍驗證器，網絡仍然保持安全。從歷史上看，退出隊列的激增通常發生在市場低迷時期或重大網絡升級之後（例如上海升級）。建議進一步分析質押獎勵和市場趨勢。
       

📄 許可證

本項目採用MIT許可證。有關詳細信息，請參閱LICENSE文件。