mcpField
M
mcp-audit

mcp-audit

github.com/rohitg00Agent 工作流2.9k150 次安装4 周前更新
代码仓库

关于 mcp-audit

mcp-audit 是一项审查 MCP 服务配置并估算工具描述令牌开销的技能，面向 Claude 用户。它帮助识别少用或功能重叠的服务，并在未经确认时不禁用任何服务。

主要功能

  1. 01列出已启用的 MCP 服务配置
  2. 02按工具数量估算开销
  3. 03检查使用情况与功能重叠
  4. 04建议保留、禁用或复核
  5. 05检查已禁用的服务

适用场景

  1. 01排查会话缓慢或成本偏高
  2. 02添加 MCP 服务前检查配置
  3. 03减少上下文占用
  4. 04审计项目专属配置

MCP 相关

该技能审计 MCP 服务配置、工具数量、使用情况及估算的提示词开销。它会提出调整建议，但禁用服务前必须获得用户确认。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rohitg00/pro-workflow --skill mcp-audit

安装后在 Claude Code 中输入/mcp-audit确认已加载。

详细介绍

MCP 审计

分析 MCP 服务开销并建议清理。

触发条件

适用于以下情况：

  • 会话感觉缓慢或成本高
  • 添加新的 MCP 服务
  • 上下文很快就被填满
  • 检查项目配置

关键见解

每个 MCP 服务都会将其所有工具描述添加到每个 API 请求中。无论是否使用这些工具，拥有 20 个工具的服务都会为每个请求增加约 2K-4K 个 token。

审计步骤

步骤 1：列出已启用的服务

检查所有 MCP 配置：

cat .claude/settings.json 2>/dev/null | grep -A 50 "mcpServers"
cat ~/.claude/settings.json 2>/dev/null | grep -A 50 "mcpServers"
步骤 2：统计每个服务的工具数量

估算每个服务的 token 开销：

  • 1-5 个工具：约 200-500 个 token（开销低）
  • 6-15 个工具：约 500-1500 个 token（开销中等）
  • 16-30 个工具：约 1500-3000 个 token（开销高）
  • 30 个以上：约 3000 个以上 token（开销过高——考虑筛选工具）
步骤 3：检查使用情况

要考虑的问题：

  • 本次会话实际使用了哪些服务？
  • 哪些服务已有 7 天以上未使用？
  • 是否有功能重叠的服务？
  • 是否有仅用于特定任务的服务？
步骤 4：提出建议

禁用符合以下情况的服务：

  • 已有 7 天以上未使用
  • 与另一个启用的服务功能重叠
  • 服务仅适用于特定项目，但你当前正在处理其他项目

保留符合以下情况的服务：

  • 每个会话都会用到（文件系统、git）
  • 提供当前工作所需的独特功能
  • 工具数量较少（少于 5 个）

输出

MCP AUDIT
  Active servers: [N]
  Total tools: [N]
  Estimated overhead: ~[N]K tokens per request

  Server Analysis:
    [name] — [N] tools, ~[N] tokens
      Status: KEEP / DISABLE / REVIEW
      Reason: [why]

  Recommendations:
    Disable: [list]
    Keep: [list]
    Review: [list]

  Projected savings: ~[N]K tokens per request (~$X.XX per session)

阈值

  • 服务总数：少于 10 个（理想），10-15 个（需监控），超过 15 个（需减少）
  • 工具总数：少于 80 个（理想），80-120 个（需监控），超过 120 个（需减少）
  • 每个服务的工具数：少于 15 个（可以接受），15-30 个（需筛选），超过 30 个（拆分或禁用）

规则

  • 未经用户确认，绝不禁用服务
  • 估算每条建议可节省的 token 数
  • 考虑任务上下文——某个服务今天可能未使用，但明天可能至关重要
  • 检查 disabledMcpjsonServers，避免再次建议禁用已禁用的服务

评论

支持 Markdown