bookworm/bookworm-smart-assistant
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
bookworm-smart-assistant/skills/mcp-prune/SKILL.md
Bookworm Admin b7a8e29d21 release: v6.7.0 - OTA E2E test release 
- 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)
2026-04-27 17:59:44 +08:00

1.9 KiB
Raw Permalink Blame History

name version description maturity allowed-tools
mcp-prune 1.0.0 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"。 stable
Bash
Read

/mcp-prune — MCP 剪枝分析

基于 scripts/mcp-usage-tracker.js 产出的使用率数据，识别并报告低频 MCP 候选。绝不自动修改 ~/.claude.json — 用户必须人工 apply。

安全边界

能力 默认 --plan --confirm
只读分析 ✅ ✅ ✅
生成 plan 文件 — ✅ ✅
修改 .claude.json ❌ ❌ ❌ (永远不自动改)
打印 apply 指令 — — ✅

执行

# 报告模式 (默认 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