serverprobe-debuglisted
Install: claude install-skill wcpe/serverprobe-mcp-debug
# ServerProbe 调试技能
ServerProbe 是装在 Minecraft 服务器里的运维探针插件（单 jar 多端：Paper/Folia/Spigot 1.8–1.21.x、BungeeCord、Velocity 3.1.1–4.x）。它的核心价值：**开启 MCP 控制面后，外部 agent（你）可以不经人工操作，直接远程完成"读指标 → 定位 → 深度诊断"的全链路**。
本技能覆盖完整链路：下载 jar → 部署配置 → 启动服务器 → MCP 对接 → 按场景调用工具。
## 1. 下载
从 GitHub Releases 拿最新版 jar（单文件，约 40MB，内嵌 Arthas 闭包与原生库）：
```bash
# 查最新版本号
curl -s https://api.github.com/repos/wcpe/ServerProbe/releases/latest | grep tag_name
# 下载（替换 <version>）
curl -sL -o ServerProbe-<version>.jar \
"https://github.com/wcpe/ServerProbe/releases/download/v<version>/ServerProbe-<version>.jar"
```
本地开发版构建：`./gradlew build`，产物在 `plugin/build/libs/ServerProbe-<version>.jar`。
## 2. 部署与配置
1. jar 放入服务器的 `plugins/` 目录，重启服务器；首次启动生成 `plugins/ServerProbe/config.yml`。
2. **要启用 MCP 调试，必须改配置**（默认关闭）。在 `config.yml` 中确认或追加：
```yaml
mcp:
enabled: true
host: "127.0.0.1" # 本机调试用回环；跨机改 "0.0.0.0" 并务必设 secret
port: 9942
secret: "" # 生产环境务必设 Bearer 密钥；空密钥启动时会打中文 WARN
```
改完**重启服务器**生效（`mcp` 段首次生成时 enabled 就是 false，需要手动改）。
3. 验证启动成功：日志出现 `MCP 控制面已启动，监听 127.0.0.1:9942/mcp`。
## 3. MCP 对接（JSON-RPC over HTTP）
端点：`POST http://<host>:9942/mcp`，协议 JSON-RPC 2.0，Bearer 鉴权（secret 非空时带头 `Authorization: Bearer <secret>`）。
**三次调用完成握手与探查**（curl 示例）：
```bash
MCP="http://127.0.0.1:9942/mcp"
# 1. 初始化
curl -s -X POST $MCP -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'
# 2. 列工具（42 个，返回 name/description/inputSchema）
curl -s -X POST $MCP -H "Content-Type: