内容
# AvaxOps
**面向 Avalanche 验证节点和 L1 的 AI 原生运维层。**
🔗 **在线站点：** [avax-ops.vercel.app](https://avax-ops.vercel.app)
询问您的 AI 代理： *"本周哪些验证节点需要关注？"* — 然后获得实际答案。
## 组件
- **`mcp-server/`** — 开源 MCP 服务器，暴露 Avalanche 运维工具（验证节点健康、过期、余额、诊断）给 Claude、Cursor、Claude Code 或任何 MCP 兼容的代理。MIT 许可。
- **`service/`** *(计划中，M2)* — 监控后端：轮询 P-Chain 和节点健康，评估警报阈值（正常运行时间 → 90% ACP-267 限制、即将过期的验证、L1 余额低、版本滞后）。
- **`bot/`** *(计划中，M2)* — 用于节点注册、实时警报和每周集群摘要的 Telegram 机器人。
## 状态
**v0.1 — 具有 5 种可用工具的 MCP 服务器，已针对 Fuji 和主网 P-Chain APIs 进行验证。**
为 Avalanche Team1 Builder Grants 计划而构建；请参阅 `docs/grant-application.md` 获取路线图。
## MCP 工具
| 工具 | 功能 |
|------|--------------|
| `ping` | 服务器 + P-Chain 连接性检查（网络、链高度）。 |
| `list_validators` | 集群表格：权益（AVAX）、正常运行时间、连接性、委托者、开始/结束、剩余天数。 |
| `expiration_report` | 验证节点验证期在 N 天内（默认为 30 天）结束。 |
| `validator_health` | 单个验证节点报告，包括 **ACP-267 90% 正常运行时间检查**；可选地读取您节点的 Info/Health APIs（版本、引导状态、健康检查）。 |
| `balance_check` | P-Chain 地址余额（总/解锁/锁定）和 L1 验证节点连续费用余额，带有预计剩余时间。 |
所有工具都是 **只读** 且无需配置即可访问公共数据。无需密钥，无需签名，无需账户。
## 安装
需要 Python 3.11+ 和 [uv](https://docs.astral.sh/uv/)。
```bash
git clone https://github.com/EMPangolin/avax-ops.git
cd avax-ops
uv venv
uv pip install -e mcp-server
```
## 在 Claude Code 中使用
```bash
claude mcp add avax-ops -e AVAX_NETWORK=mainnet -- \
uv --directory /path/to/avax-ops run avax-ops-mcp
```
然后直接询问：
> "显示我所有验证节点在接下来的 30 天内即将过期。"
> "节点 ID-7Xhw2mDx... 是否满足 ACP-267 正常运行时间要求？"
> "我的 L1 验证节点的费用余额中还剩下多少 AVAX？"
在 Claude Desktop、Cursor 或任何 MCP 客户端（stdio 传输，命令 `avax-ops-mcp`）中同样适用。
## 配置
| 环境变量 | 默认值 | 含义 |
|---------|---------|---------|
| `AVAX_NETWORK` | `mainnet` | `mainnet` 或 `fuji`（测试网）。 |
## 示例输出
针对实时 Fuji 验证节点的 `validator_health`：
```json
{
"nodeID": "NodeID-CRVEYUqnqNvCSBnWGQ8c1Fmg2qHZe581E",
"found": true,
"network": "fuji",
"connected": true,
"uptime_pct": 99.9958,
"uptime_meets_acp267_90pct": true,
"stake_AVAX": 1.0,
"end": "2026-08-18 05:30 UTC",
"days_remaining": 40.3
}
```
<!-- screenshot: add a Claude Code session screenshot here (agent calling the tools) -->
## 开发
```bash
cd mcp-server
uv pip install --group pyproject.toml:dev # pytest, pytest-asyncio, ruff
pytest tests/ -q # unit tests (RPC layer mocked)
ruff check src tests && ruff format --check src tests
```
API 字段名称（例如权益作为 nAVAX 中的 `weight` 到达，而不是旧的 `stakeAmount`）已针对实时 P-Chain API 进行验证；测试装置镜像真实的捕获响应。
## 路线图
- **M1** — MCP 服务器 v0.1，只读运维工具 *(此版本)*
- **M2** — 监控服务 + Telegram 警报（正常运行时间、过期、L1 余额）
- **M3** — AI 诊断（`diagnose_node`）、充值估算器、L1 配置助手
- **M4** — Web 仪表板、文档、演示
## 许可证
MIT
