b7a8e29d21
- VERSION file as authoritative version source - export.mjs reads VERSION with package.json fallback - bw-ota.ps1 DryRun mode for safe testing - auto-setup.ps1 bumped to v3.2.0 (Phase 8 OTA)
70 lines
1.9 KiB
Markdown
70 lines
1.9 KiB
Markdown
---
|
||
name: mcp-prune
|
||
version: 1.0.0
|
||
description: |
|
||
MCP 剪枝分析工具 (Phase 1 · T1.4)。基于 mcp-usage-tracker 的使用率数据，
|
||
识别最近 N 天零调用且非 critical 的 MCP 候选，生成剪枝 plan 文件。
|
||
绝不自动修改 ~/.claude.json，用户需人工 apply。
|
||
触发词: "mcp-prune", "剪枝 MCP", "MCP 剪枝", "清理 MCP", "精简 MCP",
|
||
"disable unused MCP", "prune MCP servers"。
|
||
maturity: stable
|
||
allowed-tools:
|
||
- Bash
|
||
- Read
|
||
---
|
||
|
||
# /mcp-prune — MCP 剪枝分析
|
||
|
||
基于 `scripts/mcp-usage-tracker.js` 产出的使用率数据，识别并报告低频 MCP
|
||
候选。**绝不自动修改** `~/.claude.json` — 用户必须人工 apply。
|
||
|
||
## 安全边界
|
||
|
||
| 能力 | 默认 | --plan | --confirm |
|
||
|------|------|--------|-----------|
|
||
| 只读分析 | ✅ | ✅ | ✅ |
|
||
| 生成 plan 文件 | — | ✅ | ✅ |
|
||
| 修改 .claude.json | ❌ | ❌ | ❌ (永远不自动改) |
|
||
| 打印 apply 指令 | — | — | ✅ |
|
||
|
||
## 执行
|
||
|
||
```bash
|
||
# 报告模式 (默认 30 天窗口)
|
||
node ~/.claude/scripts/mcp-prune.js
|
||
|
||
# 7 天窗口 (更激进)
|
||
node ~/.claude/scripts/mcp-prune.js --days 7
|
||
|
||
# 写入 plan 文件
|
||
node ~/.claude/scripts/mcp-prune.js --plan
|
||
|
||
# 打印用户 apply 步骤
|
||
node ~/.claude/scripts/mcp-prune.js --confirm
|
||
```
|
||
|
||
## 剪枝逻辑
|
||
|
||
- 候选条件: 窗口内 0 调用 **AND** 不在 `~/.claude/mcp-critical-allowlist.json` 中
|
||
- 豁免: critical 清单永远保留
|
||
- 数据源:
|
||
- 使用率: `~/.claude/debug/activity-*.jsonl` (event=='mcp')
|
||
- 白名单: `~/.claude/mcp-critical-allowlist.json`
|
||
- 配置: `~/.claude.json` (只读)
|
||
|
||
## 输出
|
||
|
||
- 报告到 stdout
|
||
- --plan 时写入 `~/.claude/mcp-prune-plan-<date>.json`
|
||
- --confirm 追加 apply 指令 (PowerShell + 编辑 .claude.json 指引)
|
||
|
||
## 关联
|
||
|
||
- 依赖: `scripts/mcp-usage-tracker.js` (Phase 1 · T1.1)
|
||
- 依赖: `mcp-critical-allowlist.json` (Phase 1 · T1.5)
|
||
- 消费方: 用户手动 apply plan
|
||
|
||
## sentinel
|
||
|
||
PHASE1_T1_4_MCP_PRUNE_2026_04_24
|