dr-mcp

dr-mcp

清理 MCP。

dr-mcp 是一款本地优先的 MCP 审计与清理工具，面向每天使用 Agentic 编码的开发者。它会扫描工具加载的 Model Context Protocol 配置，查找过时的服务、弃用的包、重复条目、占用大量上下文的工具、高风险权限和重大版本升级，然后生成可逆的修补计划。

如果你在多个项目中使用 Claude Code、OpenAI Codex、Cursor、Windsurf、GitHub Copilot、VS Code、Cline、Roo Code、Continue 或 Zed，MCP 配置可能会在不知不觉中不断膨胀：过时的演示服务、重复的 GitHub 工具、宽泛的文件系统访问权限、落后于 npm latest 的包版本锁定、弃用的代码库，以及 Agent 写代码前必须考虑的大量工具。

dr-mcp 会指出需要清理的内容，扫描时不会删除任何内容。

npx @inferensys/dr-mcp cleanup

这会在当前项目中启动本地清理扫描。你将获得一份已脱敏的报告、一份按上下文占用量排序的 MCP 列表、包和代码库的新鲜度信号，以及可在审核后应用的修补计划。

如需执行完整清理扫描，包括包／代码库检查和本地安装历史记录追踪：

npx @inferensys/dr-mcp cleanup --registry --track-usage

在 Claude Code、Codex、Cursor、Windsurf、GitHub Copilot 或任何可公开服务器提示词／工具的 MCP 客户端中，使用 dr_mcp_scan 或 dr_mcp_cleanup。如果你的客户端会将 MCP 提示词映射为斜杠命令，请使用 /dr-mcp scan。

为什么要清理 MCP？

MCP 服务之所以强大，是因为它们能将工具直接接入 Agent 的工作循环。这也意味着，每增加一个服务，都可能带来工具选择噪声、上下文窗口压力、启动失败、过时依赖，或你已不打算授予的权限。

dr-mcp 可帮助你：

• MCP 审计： 汇总全局和项目 MCP 配置，生成一份报告。
• MCP 清理： 检查重复项、失效条目、弃用的包、长期安装和庞大的工具集等候选项。
• MCP 上下文整洁： 估算不适用于每次编码会话的服务所包含的工具数量及其上下文占用量。
• MCP 安全审查： 检查宽泛的文件系统访问权限、内联密钥、疑似密钥的参数，以及失效的环境变量引用。
• MCP 升级规划： 检查相对于 npm latest 的 semver 差异，包括值得审核的重大升级。
• MCP 修复计划： 在写入前明确列出操作，并提供备份和差异。

它能帮你解决的问题

• 释放上下文。 查看哪些 MCP 为 Agent 的提示词添加了最多工具。
• 减少不需要的工具调用。 移除 Agent 会持续考虑、但项目并不需要的旧服务。
• 弃用过时的 MCP。 使用 --registry 检查 npm 元数据和 GitHub 活动，找出已归档或过时的项目。
• 查看重大升级。 找出版本锁定远落后于 npm latest 的 MCP 包，并审核升级计划。
• 找出遗留项。 启用 --track-usage，建立本地记录，追踪扫描中反复出现的 MCP。
• 移除重复项。 找出在 Claude、Cursor、VS Code、Codex、Windsurf 或项目文件中重复注册的 MCP。
• 修复高风险配置。 标记宽泛的文件系统访问权限、内联密钥、疑似密钥的参数、缺失的命令、失效路径和错误的环境变量引用。
• 停止使用浮动安装。 检查使用 latest 或未指定版本的 npx 包。

审计工作原理

dr-mcp 使用实用的静态分析和软件包元数据检查：

1. 发现配置文件，包括 Claude Desktop、Claude Code、Codex、Cursor、Windsurf、GitHub Copilot、VS Code、Cline、Roo Code、Continue、Zed 和 .mcp.json。
2. 解析并规范化 JSON、TOML 和 YAML 配置结构，将其统一为内部 MCP 服务模型。
3. 评估设置，从可靠性、安全性、上下文整洁度和可维护性等方面进行评分。
4. 检查软件包是否为最新版本，使用 npm 元数据、semver 分类、dist-tags.latest，以及可选的官方注册表匹配。
5. 估算上下文占用量，使用工具数量启发式方法，评估 GitHub、浏览器自动化、Slack、Jira、文件系统和数据库等工具覆盖面较广的 MCP。
6. 查看维护信号，在有仓库元数据时检查 GitHub 存档状态和近期推送活动。
7. 生成补丁计划，包含 JSON Pointer 目标、幂等操作、带时间戳的备份和差异。

命令

# Local audit in the current project
npx @inferensys/dr-mcp

# Deeper cleanup report with package/repo checks and local install history
npx @inferensys/dr-mcp cleanup

# Full scan alias for agent workflows
npx @inferensys/dr-mcp scan --deep

# Local-only cleanup flow with no network checks or usage ledger writes
npx @inferensys/dr-mcp cleanup --local

# JSON for scripts or CI
npx @inferensys/dr-mcp scan --workspace . --json --registry

# Shareable cleanup report
npx @inferensys/dr-mcp report --workspace . --format html > dr-mcp-report.html

# Preview a repair plan
npx @inferensys/dr-mcp patch --workspace . --plan remove-duplicate-servers
npx @inferensys/dr-mcp patch --workspace . --plan upgrade-stale-packages

# Apply a reviewed repair plan with backups
npx @inferensys/dr-mcp patch --workspace . --plan remove-duplicate-servers --apply

# Run as an MCP server
npx @inferensys/dr-mcp server

报告章节

• 评分： 可靠性、安全性、上下文整洁度、可维护性。
• 软件包升级： 版本低于 npm 最新版本的 MCP 软件包固定版本，包括主版本升级。
• 上下文占用量： 按估算的工具负载对 MCP 排序。
• 安装历史： 来自本地使用记录的长期运行服务。
• 问题发现： 包含源配置路径的具体问题。
• 补丁计划： 安全编辑方案，例如移除重复项、失效条目、已弃用服务或上下文占用量较大的服务。

清理计划

dr-mcp 将问题发现与操作分开。问题发现会指出可能存在的问题；补丁计划则会说明它可以执行的确切配置编辑。

• remove-duplicate-servers：移除重复的 MCP 服务条目，同时保留第一个启用的定义。
• remove-dead-servers：移除无法启动的条目或 npm 上已不存在的软件包。
• upgrade-stale-packages：将 MCP 软件包引用更新到 npm 最新版本。
• remove-abandoned-servers：移除来自已存档或弃用仓库的服务。
• remove-heavy-context-servers：移除预计会在每个会话中加载大量工具的服务。
• remove-long-lived-servers：确认不再需要后，移除在多次跟踪扫描中一直保持安装状态的服务。

支持的工具

工具	扫描的配置
Claude Desktop	claude_desktop_config.json
Claude Code / cc	~/.claude.json、~/.claude/settings.json、.claude/settings.json
OpenAI Codex	~/.codex/config.toml、.codex/config.toml
Cursor	~/.cursor/mcp.json、.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json、.windsurf/mcp.json
VS Code 中的 GitHub Copilot	VS Code 用户设置、VS Code Insiders 设置、.vscode/mcp.json、.vscode/settings.json
GitHub Copilot CLI	~/.copilot/mcp-config.json、.copilot/mcp-config.json
Cline	~/.cline/data/settings/cline_mcp_settings.json、.cline/data/settings/cline_mcp_settings.json
Roo Code	.roo/mcp.json、常见的 Roo Code VS Code 全局存储路径
Continue	~/.continue/config.yaml、.continue/config.yaml
Zed	Zed 用户设置、.zed/settings.json
通用 MCP	.mcp.json

将 dr-mcp 添加到你的 Agent

添加后，先从最简单的会话内操作开始：

dr_mcp_scan

对于清理候选项、升级、弃用服务和长期安装项：

dr_mcp_cleanup

将 MCP 提示词显示为斜杠命令的客户端可能会将其显示为 dr_mcp_scan、dr_mcp_cleanup 或类似 /dr-mcp scan 的提示词。

Codex

codex mcp add dr-mcp -- npx -y @inferensys/dr-mcp server

Claude Code

claude mcp add dr-mcp -- npx -y @inferensys/dr-mcp server

JSON 配置客户端

适用于 Claude Desktop、Cursor、Windsurf、Cline、Roo Code、VS Code 和 VS Code 中的 GitHub Copilot：

{
  "mcpServers": {
    "dr-mcp": {
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

VS Code 和 GitHub Copilot 可能使用 servers：

{
  "servers": {
    "dr-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

Zed

{
  "context_servers": {
    "dr-mcp": {
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

Continue

mcpServers:
  dr-mcp:
    command: npx
    args:
      - -y
      - @inferensys/dr-mcp
      - server

MCP 工具

作为服务运行时，dr-mcp 会公开以下工具：

• dr_mcp_scan
• dr_mcp_cleanup
• scan_mcp_setup
• explain_issue
• generate_patch_plan
• apply_patch_plan
• export_report

MCP 提示词

• dr_mcp，使用 action=scan 或 action=cleanup
• dr_mcp_scan
• dr_mcp_cleanup

安全性

扫描不会编辑 MCP 客户端配置。

补丁计划会在写入前创建带时间戳的备份。报告会对机密、令牌、电子邮件、主目录路径和私有 GitHub 仓库 URL 进行脱敏。

使用情况跟踪默认关闭。--track-usage 会在 ~/.dr-mcp/usage-ledger.json 写入本地记录。它会跟踪扫描期间仍处于安装状态的内容；除非客户端提供相应数据，否则不会声称掌握每个工具的实际使用情况。

dr-mcp 不会自动安装、卸载或升级软件包，也不会执行破坏性清理。

开发

npm install
npm run check
node dist/cli.js scan --workspace tests/fixtures/mixed --json

注册表名称：io.github.Inferensys/dr-mcp

软件包：@inferensys/dr-mcp