MCP Security & Vulnerability Auditor

MCP Security Auditor 服务

这是一款可用于生产环境的 Model Context Protocol（MCP）服务，为 AI 编码助手（Claude Desktop、Cursor、Windsurf、Cline）提供原生安全分析工具。它支持 AI Agent 在接入或执行其他 MCP 服务、工具仓库和本地代码库之前，对其进行静态审计，排查严重安全漏洞。

---

🛠️ 提供的 MCP 工具

本服务实现了官方 Model Context Protocol 规范（tools/list 和 tools/call）：

1. audit_mcp_repository

对包含 MCP 服务实现的 Git 仓库执行自动化、零执行的静态抽象语法树（AST）安全审计。

• 参数：
  • repository_url（string，必填）：要审计的 MCP 服务仓库的公开 Git URL（例如 https://github.com/example/mcp-server）。
  • sub_directory（string，可选）：要检查的仓库内特定子目录（适用于 monorepo）。
• 检查的漏洞：
  • CWE-78（命令注入）： 检测工具执行代码块中未净化的 subprocess.run、child_process.exec 和 shell 调用。
  • CWE-22（路径遍历）： 标记缺少路径规范化（os.path.realpath、边界检查）的无限制文件读写操作。
  • CWE-798（硬编码密钥）： 识别工具架构或服务定义中泄露的 API 密钥、令牌和企业凭证。
  • CWE-306（缺少身份验证）： 标记未使用 bearer 身份验证、却暴露破坏性功能的公共 HTTP/SSE 传输。
  • CWE-1336（工具和提示词注入）： 标记容易遭受提示词劫持的工具描述。
• 返回：
  • trust_score（0–100）：加权安全指数。
  • grade（"A+"、"A"、"B"、"C"、"F"）：安全等级。
  • findings（数组）：逐行列出的漏洞记录，包含 CWE 标识符和修复说明。
  • markdown_report（string）：预先格式化、便于阅读的审计报告。

2. audit_local_directory

在部署前审计包含 MCP 服务源代码的本地文件系统目录。

• 参数：
  • directory_path（string，必填）：目标目录的绝对或相对文件系统路径。
• 返回： 结构化 JSON 审计记录和修复清单。

---

🚀 客户端配置与快速入门

1. Claude Desktop 设置

将服务添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "mcp-security-auditor": {
      "command": "python3",
      "args": ["/path/to/mcp-security-auditor/server.py"]
    }
  }
}

2. Cursor IDE / Windsurf 设置

在 Cursor 中，前往 Settings → Features → MCP → Add New MCP Server：

• 名称： mcp-security-auditor
• 类型： command
• 命令： python3 /absolute/path/to/server.py

3. Docker 容器运行

使用预配置的 Dockerfile 通过 Docker 隔离运行：

{
  "mcpServers": {
    "mcp-security-auditor": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ansarii/mcp-security-auditor"
      ]
    }
  }
}

---

💻 Agent 使用示例

连接后，你的 AI 助手可以在安装工具前执行安全预检：

User: "Audit the MCP server at https://github.com/modelcontextprotocol/servers before I install it."

Claude (Tool Call):
audit_mcp_repository({
  "repository_url": "https://github.com/modelcontextprotocol/servers",
  "sub_directory": "src/fetch"
})

Result:
{
  "status": "success",
  "target_name": "servers:src/fetch",
  "trust_score": 95,
  "grade": "A+",
  "findings_count": 0,
  "recommendation": "SAFE_TO_CONNECT"
}

---

🔒 安全保障：零执行

与会执行任意 stdio 二进制文件（从而在主机上造成直接远程代码执行风险）的运行时扫描器不同，本 MCP 服务使用纯静态抽象语法树（AST）分析。它会检查 Python、TypeScript 和 JSON-RPC 实现，但绝不会执行不受信任的代码。

---

📜 许可证

MIT License — Copyright (c) 2026 Neon Innovation Lab.