AI导哈

MCP服务器安全审计工具

MCP Shield是一款CLI工具，用于自动发现和审计本地配置的MCP服务器，提供安全检查和信任评分功能。

  • by aaronlab
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aaronagent/mcp-shield

使用说明

🛡️ MCP Shield

Security Auditor & Trust Dashboard for MCP Servers
Scan. Score. Secure — before your AI agent gets compromised.

MCP Shield是一个CLI工具 自动发现 您的本地配置 MCP（模型上下文协议） 服务器，运行 8类安全检查，分配一个 信任评分（A-F），并生成漂亮的报告——所有这些都在一个命令中完成。

$ mcp-shield scan

  ╔══════════════════════════════════════════════════════════════╗
  ║                  🛡️  MCP Shield v1.0                        ║
  ║              Security Auditor & Trust Dashboard              ║
  ╚══════════════════════════════════════════════════════════════╝

  📍 Discovered 4 MCP servers across 3 config files

  ┌──────────────────┬───────┬───────┬──────────────────────────┐
  │ Server           │ Score │ Grade │ Top Finding              │
  ├──────────────────┼───────┼───────┼──────────────────────────┤
  │ filesystem       │  85   │   A   │ SCOPE-001: broad perms   │
  │ github           │  72   │   B   │ ENV-002: hardcoded token │
  │ puppeteer        │  41   │   D   │ NET-001: binds 0.0.0.0   │
  │ sketchy-mcp      │  18   │   F   │ KNOWN-001: risky package │
  └──────────────────┴───────┴───────┴──────────────────────────┘

  ⚠  Overall Trust Score: 54 / 100 (C)
  💡 Run `mcp-shield fix <server>` for remediation steps.

MCP是2026年人工智能代理工具的支柱，但大多数服务器在运行时没有进行任何安全审查。 MCP Shield改变了这一点。

⚡ 快速开始

pip install mcp-shield

# Scan all auto-discovered MCP servers
mcp-shield scan

# Generate an HTML trust dashboard
mcp-shield scan --format html -o report.html

# Get remediation guidance for a specific server
mcp-shield fix filesystem

就是这样，没有配置文件，没有API密钥，没有设置。

🤔 为什么选择MCP Shield？

MCP服务器是 新攻击面 AI代理时代。单个配置错误的服务器可以：

  • 🔓 泄露API密钥和秘密 --env-vars或命令args中的硬编码标记
  • 🌍 将本地服务暴露于互联网 --服务器绑定到 0.0.0.0 无意
  • 💉 启用命令注入 --服务器启动命令中的shell调用
  • 📤 清除数据 --同时具有文件系统和网络访问的服务器
  • 🎭 运行键入的包 --无范围 npx/uvx 从公共注册表安装

大多数开发人员只配置一次MCP服务器，再也不会审核它们。MCP Shield为您提供 连续能见度 只需一个命令。

✨ 特性

特性 描述
自动发现 从Claude代码、游标和项目级配置中自动查找服务器
8安全检查类别 跨范围、命令、环境、包、网络、泄漏、已知风险和权限检查的15+个单独规则
信任评分 每台服务器和整体A-F字母等级为0-100分
丰富的CLI输出 ASCII艺术横幅、彩色表格、严重性编码结果 富有的
HTML仪表板 Glassmorphism深色主题报告，带有动画SVG信任度量
JSON导出 CI/CD管道的机器可读输出
指导性补救 mcp-shield fix 为每个发现提供逐步修复
零配置 开箱即用——只需安装并扫描

📍 自动发现

MCP Shield知道该往哪里看。它会自动扫描：

客户端 配置路径
克劳德代码 ~/.claude/settings.json, ~/.claude.json
光标 ~/.cursor/mcp.json
项目级别 .mcp.json, .cursor/mcp.json 在当前目录中

通过 --path 扫描任何自定义配置位置：

mcp-shield scan --path /path/to/custom/config.json

🔍 安全检查参考

ID 类别 严重性 检测内容
SCOPE-001 范围 🔴 高 通配符(*)在权限允许列表中
SCOPE-002 范围 🟡 中等 完全缺少权限允许列表
CMD-001 命令 🔴 高 Shell调用(sh -c, bash -c, cmd /c)
CMD-002 命令 🟡 中等 通过字符串插值命令注入风险
ENV-001 环境 🟡 中等 敏感环境变量名称(*_KEY, *_SECRET, *_TOKEN)
ENV-002 环境 🔴 高 硬编码机密（API密钥、明文令牌）
PKG-001 包装 🟡 中等 未处理 npx 包装（打字风险）
PKG-002 包装 🟡 中等 未处理 uvx 包装（打字风险）
NET-001 网络 🔴 高 服务器绑定到 0.0.0.0 （所有接口）
NET-002 网络 🟡 Medium 参数中的显式端口暴露
EXFIL-001 渗出 🔴 高 文件系统+网络访问组合（数据泄露风险）
EXFIL-002 渗出 🟡 中等 通过出站网络对敏感路径进行写访问
KNOWN-001 已知风险 🔴 高 在已知有风险的MCP服务器数据库中发现包
PRIV-001 特权 🔴 高 sudo in服务器命令
PRIV-002 特权 🔴 高 跑步 root
PRIV-003 特权 🔴 高 Docker --privileged 旗帜

🎯 用法示例

基本扫描

mcp-shield scan

HTML信任仪表板

mcp-shield scan --format html -o report.html

生成一个深色主题的glassmorphism仪表板，其中包含动画SVG信任评分表、每台服务器的细分和查找详细信息。打开 report.html 在任何浏览器中。

CI/CD的JSON输出

mcp-shield scan --format json

# Use in CI pipelines — fail if overall grade is below B
mcp-shield scan --format json | jq -e '.overall_grade <= "B"'

扫描特定配置

mcp-shield scan --path ~/.cursor/mcp.json

获取补救步骤

mcp-shield fix puppeteer

  🔧 Remediation for: puppeteer

  NET-001 (High) — Server binds to 0.0.0.0
  ├─ Risk:  Exposes server to all network interfaces
  ├─ Fix:   Change bind address to 127.0.0.1
  └─ Where: args: ["--host", "0.0.0.0"] → ["--host", "127.0.0.1"]

  SCOPE-001 (High) — Wildcard permission allow-list
  ├─ Risk:  Server has unrestricted tool access
  ├─ Fix:   Explicitly list only the tools you need
  └─ Ref:   https://modelcontextprotocol.io/docs/security

🏗️ 信任评分

每台服务器接收一个 0–100信任度评分 基于加权结果：

等级 分数 含义
A. 90-100 非常好——很少或没有问题
B 80-89 很好——只有小问题
C 65-79 一般——存在中等风险
D 50-64 差-重大安全问题
F 0-49 失败——关键风险，需要立即采取行动

评分权重：🔴 高发现扣除 15分, 🟡 中等扣除额 5分, 🔵 低扣除额 2分.

🛠️ 安装

要求： Python 3.9+

# From PyPI (recommended)
pip install mcp-shield

# From source
git clone https://github.com/aaronagent/mcp-shield.git
cd mcp-shield
pip install -e .

唯一的运行时依赖关系是 rich 用于CLI输出。

🤝 贡献

欢迎投稿！以下是如何参与其中：

  1. 叉子 存储库
  2. 创建 特征分支(git checkout -b feat/new-check)
  3. 提交 您的更改(git commit -m 'Add new security check')
  4. 推 到分行(git push origin feat/new-check)
  5. 打开 拉取请求

需要帮助的领域

  • 🆕 新的安全检查规则
  • 🌐 支持更多MCP客户端（VS Code、Windsurf等）
  • 🧪 测试覆盖率
  • 📖 文件和翻译
  • 🐛 错误报告

请看 贡献.md 详细指南。

📄 许可证

MIT© 亚伦代理人

⭐ 明星历史

如果MCP Shield有助于保护您的AI代理设置，请考虑给它一个⭐ — 它帮助其他人发现这个项目。

中文说明

🛡️ MCP Shield — MCP 服务器安全审计工具

MCP Shield 是一款命令行工具，专为 AI Agent 生态中的 MCP（模型上下文协议）服务器 提供安全扫描和信任评估。

为什么需要 MCP Shield？

2026 年，MCP 已成为 AI Agent 工具链的核心协议。然而，大多数开发者在配置 MCP 服务器后从未进行过安全审计。一个错误配置的服务器可能导致：

  • 🔑 API 密钥和凭据泄露
  • 🌐 本地服务意外暴露到公网
  • 💉 命令注入攻击
  • 📤 敏感数据被窃取
  • 🎭 恶意包通过 typosquatting 入侵

核心功能

  • 自动发现 — 自动扫描 Claude Code、Cursor 等客户端的 MCP 配置文件
  • 8 大类安全检查 — 覆盖权限、命令、环境变量、包管理、网络、数据外泄、已知风险、特权提升
  • 信任评分 — 0–100 分，A–F 等级评估
  • 多种输出格式 — 彩色终端表格、HTML 可视化仪表盘、JSON（支持 CI/CD 集成）
  • 修复指引 — 逐步指导修复每一项安全发现

快速开始

pip install mcp-shield

# 扫描所有已发现的 MCP 服务器
mcp-shield scan

# 生成 HTML 报告
mcp-shield scan --format html -o report.html

# 查看修复建议
mcp-shield fix <server-name>

参与贡献

欢迎提交 Issue 和 Pull Request！详见 贡献.md。

Built with 🔒 by AARON AGENT
Securing the AI agent ecosystem, one MCP server at a time.

相关 MCP