用途:为从第三方来源安装 MCP 服务器提供安全导向的工作流,适用于社区维护者(非官方 Anthropic 包)的服务器、仓库有热度但维护者未知、需要固定版本且无法做完整代码审查的场景。
主要能力与流程:
- 按指定提交克隆:mkdir -p ~/.claude/mcp-audits 后 git clone <REPO_URL> <SERVER_NAME>,git checkout <COMMIT_SHA>,并记录提交信息。
- 自动安全扫描:运行 ~/.claude/skills/secure-mcp-install/scripts/audit-mcp-server.sh <路径>,检查危险代码模式(eval、exec、动态导入)、混淆或压缩源码、可疑网络调用与硬编码 URL、环境变量访问、凭据窃取迹象及已知恶意软件特征;HIGH 级发现需人工调查。
- 依赖审计:Node.js 用 npm audit --audit-level=high 或 yarn audit --level high;Python 用 pip-audit -r requirements.txt,关注已知漏洞、仿冒包名、异常低下载量、关键包近期所有权转移。
- 人工复核重点:入口点、工具处理器、网络代码、文件系统访问、环境变量处理、构建脚本(如 postinstall)。
- 生成审计报告:记录服务器信息、提交、扫描与依赖结果、人工笔记及 APPROVED/REJECTED/CONDITIONAL 决定。
- 固定版本安装:从本地克隆安装(npm install、npm run build 或创建 venv 后 pip install -e .),用 claude mcp add-json <名称> '<json>' 注册;手动编辑 ~/.claude.json 会在重启时被覆盖,必须用 CLI。
- 禁用自动更新:因从本地克隆安装,不会自动更新;升级时 git fetch origin、git diff HEAD origin/main、重跑完整审计后再切换提交。
限制与注意:仅提供流程与脚本,未提供具体扫描规则细节;Windows 需用 cmd /c npx;项目级 .mcp.json 可直接编辑,用户级 ~/.claude.json 不可;环境变量支持 ${VAR} 与 ${VAR:-default};新增服务器后需重启 Claude Code 并用 /mcp 或 claude mcp list 验证。