【免费下载链接】mcp-audit-tool
🛡️ Security audit CLI for Model Context Protocol (MCP) servers — scan AI agent configs for tool poisoning, rug pulls, hardcoded secrets, command injection & supply-chain risks. Pure Python, SARIF + CI ready.
mcp-audit-tool 是一个专为 Model Context Protocol（MCP）服务器设计的开源安全审计 CLI 工具，能快速扫描 AI Agent 配置中的工具投毒、供应链攻击、硬编码密钥、命令注入等安全风险。它纯 Python 实现、零配置、无需 Node.js 和 Docker，只需 5 分钟即可完成安装并跑通第一次 MCP 安全扫描。
什么是 mcp-audit-tool：为什么需要 MCP 安全扫描
MCP（Model Context Protocol）是 Claude Desktop、Cursor、Windsurf、Zed 等 AI 客户端调用外部工具、读取文件、执行命令的开放标准。配置越强大，风险越大——一行不起眼的配置就可能让模型：
- 🔑 拿到明文写在
env里的 API Key - 📦 每次启动都拉取未锁版本的第三方包（经典 rug pull）
- 🐚 执行
curl … | bash之类的任意安装脚本 - 🕳️ 被注入到工具描述中的"隐藏指令"诱导（工具投毒）
mcp-audit-tool 正是为此而生的静态扫描器，核心特性：
- 🧠 内置12 条检测规则（MAT-001 ~ MAT-012），覆盖工具投毒、rug pull、密钥泄露、命令注入、不安全传输等风险，规则实现在 src/mcp_audit_tool/rules/ 目录
- 🔎零配置自动发现Claude Desktop、Cursor、Windsurf、Cline、Zed、VS Code 的 MCP 配置文件
- 📊 输出 A+ → F 安全评分和可执行的修复建议
- 📊 支持终端报告、JSON、SARIF 2.1.0 三种输出格式（src/mcp_audit_tool/reporters/）
- 🐍 纯 Python 3.9+，仅依赖
typer、rich、pyyaml三个小包，见 pyproject.toml
第1分钟：一键安装 mcp-audit-tool
环境要求只有一个：Python 3.9+。
推荐克隆仓库后本地安装：
git clone https://gitcode.com/gh_mirrors/mc/mcp-audit-tool.git cd mcp-audit-tool pip install .💡 项目也提供了 install.sh 一键安装脚本，会自动检查 Python 版本并通过 pipx 隔离安装，适合 macOS 和 Linux 用户。
安装完成后，用版本号命令验证是否成功：
mcp-audit --version看到mcp-audit-tool 1.0.0即表示就绪。
第2分钟：运行第一条 MCP 安全扫描命令
不带任何参数直接运行，mcp-audit-tool 会自动发现本机所有已知客户端的 MCP 配置文件（各平台路径清单定义在 src/mcp_audit_tool/discovery.py）：
mcp-audit scan自动发现覆盖这些客户端：
| 客户端 | 典型配置位置 |
|---|---|
| Claude Desktop | ~/.config/Claude/claude_desktop_config.json（macOS/Windows 路径不同） |
| Cursor | ~/.cursor/mcp.json |
| Zed | ~/.config/zed/settings.json |
| 项目级配置 | .vscode/mcp.json、.cursor/mcp.json、mcp.json |
当然，你也可以直接指定某个配置文件来审计：
# 审计指定的配置文件 mcp-audit scan ~/.cursor/mcp.json # 试试仓库自带的"故意充满漏洞"的示例配置，保证有东西可看 mcp-audit scan examples/vulnerable-claude-config.json这个示例文件 examples/vulnerable-claude-config.json 里塞了硬编码的 GitHub Token、pipe-to-shell 安装器、明文 HTTP 远程服务器和藏在工具描述里的注入指令——是练习读报告的绝佳素材。
第3分钟：读懂安全扫描报告
扫描结果是一张漂亮的终端表格，包含评分、等级、逐条发现。以示例配置为例：
╭──────────────────────────────────────────────╮ │ MCP Security Audit │ │ Score: 12/100 Grade: F │ │ 4 server(s) across 1 config file(s) │ ╰──────────────────────────────────────────────╯ Severity Rule Server Finding CRITICAL MAT-001 shady-downloader Hardcoded secret in MCP server environment CRITICAL MAT-004 shady-downloader Pipe-to-shell installer in launch command CRITICAL MAT-010 remote-api Possible tool poisoning: hidden instruction HIGH MAT-003 filesystem Unpinned MCP server package (rug-pull risk) HIGH MAT-007 filesystem Filesystem server granted root-wide access HIGH MAT-008 remote-api Remote MCP server over plaintext HTTP … CRITICAL: 3 HIGH: 4 MEDIUM: 3 Top remediations • MAT-001 Move the credential to a secrets manager. Rotate the exposed secret immediately. • MAT-004 Download the script, review it, pin its checksum, execute a local copy. • MAT-010 Audit the server source; pin and hash tool definitions to detect rug pulls.看懂三件事即可：
- Score 与 Grade：0-100 安全评分和 A+ ~ F 等级，一眼判断整体状况
- Severity：每条发现的严重程度（CRITICAL / HIGH / MEDIUM），如 MAT-001 硬编码密钥、MAT-010 工具投毒
- Remediation：每条发现都附带具体修复建议，照着改就行
运行mcp-audit rules可随时查看全部 12 条规则及默认严重级别。
第4分钟：常用命令速查表
以下命令都能直接复制使用（完整参数定义见 src/mcp_audit_tool/cli.py）：
# 输出 JSON 报告，方便脚本处理 mcp-audit scan --format json --output report.json # 输出 SARIF 格式，供代码扫描平台消费 mcp-audit scan --format sarif --output results.sarif # 发现 HIGH 及以上问题时以退出码 1 结束（用于卡 CI） mcp-audit scan --fail-on high # 查看内置的全部检测规则 mcp-audit rules退出码含义（写 CI 判断逻辑时有用）：
| 退出码 | 含义 |
|---|---|
0 | 扫描完成，没有达到--fail-on阈值的发现 |
1 | 发现达到--fail-on严重级别的问题 |
2 | 使用错误（文件不存在、解析失败、参数错误） |
第5分钟（可选）：把 MCP 安全扫描接入 CI 流水线
如果你希望每次提交都自动检查 MCP 配置安全性，可以把 mcp-audit-tool 接入 CI：
- name: Audit MCP configs run: mcp-audit scan .vscode/mcp.json --format sarif --output results.sarif --fail-on high配合--format sarif输出的 SARIF 2.1.0 报告，可以把发现结果上传到代码扫描平台，在安全面板中持续跟踪；再用--fail-on high让高危问题直接卡住构建。对团队协作来说，这是成本最低的 AI Agent 安全防线。
小结
用 5 分钟，你已经完成了 mcp-audit-tool 的完整上手流程：
- ⏱️第1分钟：克隆仓库 +
pip install .完成安装 - ⏱️第2分钟：
mcp-audit scan自动发现并扫描本机全部 MCP 配置 - ⏱️第3分钟：读懂评分、严重级别与修复建议
- ⏱️第4分钟：掌握 JSON/SARIF 输出与
--fail-on阈值控制 - ⏱️第5分钟：接入 CI，让 MCP 安全扫描成为常态化检查
在 AI Agent 配置满天飞的今天，跑一次 MCP 安全扫描的成本几乎为零，而它能帮你避开密钥泄露和工具投毒这类真实风险。想深入了解规则写法，可以看看 tests/fixtures/ 里的测试样例和 CONTRIBUTING.md 的贡献指南。
【免费下载链接】mcp-audit-tool
🛡️ Security audit CLI for Model Context Protocol (MCP) servers — scan AI agent configs for tool poisoning, rug pulls, hardcoded secrets, command injection & supply-chain risks. Pure Python, SARIF + CI ready.
相关推荐
如何快速上手Plumber：5分钟完成第一次GitHub Actions安全扫描
如何快速上手Plumber：5分钟完成第一次GitHub Actions安全扫描 Plumber 是一款免费开源的 CI/CD 安全扫描工具，专门检测 GitH
如何快速用sast-skills完成第一次安全扫描：新手5分钟上手教程
如何快速用sast skills完成第一次安全扫描：新手5分钟上手教程 sast skills 是一个开源 Agent Skills 集合，它能将你的 AI 编
如何快速上手scan4all：10分钟完成你的第一次安全扫描
如何快速上手scan4all：10分钟完成你的第一次安全扫描 想要快速掌握一款强大的安全扫描工具吗？scan4all正是你需要的终极解决方案！这是一款集成了vs
网络安全应用安全漏洞扫描渗透测试
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
