ethereum-validator-queue-mcp

用途

ethereum-validator-queue-mcp 是一个 MCP 服务器，用于实时追踪以太坊的验证者激活队列和退出队列，使 AI 智能体能够监测质押动态和网络参与趋势。

主要能力

该服务器提供以下工具与提示词：

工具

• 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...：状态：active_online，有效余额：32.00 ETH，激活纪元：123456，退出纪元：N/A。”

提示词

• analyze_queue()：为 LLM 生成用于分析队列趋势的提示词，例如“分析当前以太坊验证者队列：当前队列长度对质押需求意味着什么？这可能如何影响 ETH 价格和网络安全？如有可能请提供历史背景。”

使用方式

环境要求

• Python：3.10 或更高版本
• uv：一个快速、现代的 Python 包管理器

安装步骤

1. 克隆仓库：

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

1. 安装依赖：

uv sync

1. 安装到 Claude Desktop： 将服务器作为 Claude Desktop 应用安装：

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 替换为实际安装路径。

适用场景

可在支持 MCP 的客户端（例如 Claude Desktop）中使用自然语言提示词调用上述工具和提示词，例如：

• 获取激活队列统计：“显示当前以太坊验证者激活队列状态。”调用 get_activation_queue()。
• 获取退出队列统计：“以太坊验证者退出队列的状态如何？”调用 get_exit_queue()。
• 获取验证者状态：“检查公钥为 0x93247f2f... 的验证者状态。”调用 get_validator_status("0x93247f2f...")。
• 分析队列趋势：“分析当前以太坊验证者队列趋势。”调用 analyze_queue()，将生成的提示词发送给 LLM 进行分析。

限制

• 需要 Python 3.10 或更高版本，并使用 uv 包管理器。
• 需安装到支持 MCP 的客户端后才能通过自然语言调用。
• 示例输出基于样本数据，实际结果取决于实时数据源。
• 项目采用 MIT 许可证，详见 LICENSE 文件。