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文件。