mcp-audit-tool

技能简介

mcp-audit-tool 是一款面向 Model Context Protocol（MCP）服务器的纯 Python 安全审计 CLI 工具，专为扫描 AI Agent 配置中的安全风险而设计。随着 Claude Desktop、Cursor、Windsurf、VS Code Copilot、Zed 等主流编辑器全面支持 MCP，数以千计的公共 MCP 服务器被引入 AI 工作流，但安全研究持续揭示这一攻击面的真实威胁。mcp-audit-tool 在几秒内完成对 MCP 配置的全面审计，帮助用户在模型执行危险操作之前发现问题。

核心能力

• 12 内置检测规则：覆盖 OWASP MCP Top 10 类别，包括工具投毒（Tool Poisoning）、Rug Pull 攻击、密钥硬编码、命令注入、安装器欺骗、不安全传输、缺失认证、权限蔓延等八大风险类型
• 零配置自动发现：在 macOS、Linux、Windows 上自动定位 Claude Desktop、Cursor、Windsurf、Cline、Zed、VS Code 的所有 MCP 配置文件
• 安全评分与等级：对扫描结果给出 A+ 到 F 的安全评分和等级，并附带每条发现的可操作修复建议
• 多样化报告格式：输出格式支持美观的终端富文本报告、机器可读的 JSON、以及符合 SARIF 2.1.0 标准的结构化报告
• CI/CD 友好：支持按严重性阈值失败构建，并将结果上传至 GitHub Code Scanning
• 零运行时依赖：仅依赖 typer、rich、pyyaml 三个轻量库，Python 3.9+ 即可运行，无需 Node.js、Docker 或 LLM API Key
• 可扩展规则引擎：新增检测规则仅需编写一个小型函数，详见 CONTRIBUTING 文档

安装配置

方式一：一键安装脚本（推荐 macOS 和 Linux）

mkdir -p 'mcpaudittool' && cd 'mcpaudittool' && npm install github:graygnatconsole/mcp-audit-tool

安装脚本会自动检测 Python 3.9+ 环境、安装 pipx（通过 Homebrew），并将 CLI 安装至隔离环境中，无需 Node.js 或 nvm。

方式二：pipx 安装（推荐，各平台通用）

pipx install git+https://github.com/graygnatconsole/mcp-audit-tool.git

方式三：pip 安装

pip install git+https://github.com/graygnatconsole/mcp-audit-tool.git

方式四：源码安装

git clone https://github.com/graygnatconsole/mcp-audit-tool.git
cd mcp-audit-tool
pip install -e ".[dev]"

使用步骤

第 1 步：执行基础扫描

在终端运行以下命令，自动发现并审计本机所有 MCP 配置文件：

mcp-audit scan

第 2 步：指定配置文件扫描

如需扫描特定配置文件，可指定路径：

mcp-audit scan ~/.cursor/mcp.json

第 3 步：尝试示例扫描

项目内置了故意存在漏洞的示例配置文件，可用于测试和学习：

mcp-audit scan examples/vulnerable-claude-config.json

第 4 步：输出结构化报告

生成 JSON 格式报告（适合脚本集成）：

mcp-audit scan --format json --output report.json

生成 SARIF 格式报告（上传至 GitHub Code Scanning）：

mcp-audit scan --format sarif --output results.sarif

第 5 步：CI/CD 集成

在 GitHub Actions 中按严重性阈值失败构建（遇到 HIGH 或更高等级时退出码为 1）：

mcp-audit scan --fail-on high

附加命令：查看所有检测规则

mcp-audit rules

适用场景

• MCP 配置安全审计：在 AI 开发项目引入新的 MCP 服务器后，例行审计 claude_desktop_config.json、.cursor/mcp.json 等配置文件
• CI/CD 安全门禁：将安全扫描集成到代码流水线，在合并请求阶段阻断存在高危漏洞的 MCP 配置
• 供应链安全检查：对第三方 MCP 服务器进行入场安全审查，检测 rug pull、工具投毒等供应链攻击
• 团队安全合规：企业安全团队对内部 AI 工作站进行大规模 MCP 配置合规检查，生成统一的安全报告

适用人群

• AI 应用开发者（使用 Claude Desktop、Cursor、Windsurf 等 MCP 客户端）
• 安全工程师与红队成员（MCP 攻击面研究、渗透测试）
• DevOps 与平台工程师（AI 开发环境安全标准化）
• 企业安全团队（AI 工具合规审计与风险管控）

工作原理

mcp-audit-tool 采用纯 Python 静态分析方式，直接解析 MCP 配置文件（JSON/YAML 格式），提取 server 定义、env 变量、command 字段等信息，与 12 条内置检测规则逐一匹配，识别已知安全风险模式并输出结构化报告，无需连接外部服务或调用 LLM API，全程在本地完成。

官方链接

• GitHub 仓库：https://github.com/graygnatconsole/mcp-audit-tool
• PyPI 主页：https://pypi.org/project/mcp-audit-tool/