AI导哈

MCP安全扫描器

MCP Armor是一款针对Model Context Protocol (MCP)的全面安全扫描工具，能够自动发现、分析并保护与主流Agentic IDEs、代理和客户端集成的MCP服务器。

  • by aira-security
  • Python
  • 本地部署
  • 124 星标
  • 更新于
在 GitHub 查看 aira-security/mcp-checkpoint

使用说明

MCP Armor


🚀 概述

MCP Armor是一个用于模型上下文协议（MCP）的全面安全扫描器。自动发现、分析和保护与所有主要代理IDE、代理和客户端集成的MCP服务器。


💡 特性

  • 🔍 自动发现：查找常用代理IDE（如Cursor、Windsurf、VS Code、Claude Desktop等）的已知MCP配置
  • 🔧 工具、资源和即时库存：连接到MCP服务器并编目可用的工具、资源和提示模板
  • 🛡️ 证券分析：专门的安全检查，包括快速注射、Rug Pull攻击、跨服务器工具阴影、工具中毒、工具名称模糊、， 以及更多。.
  • 🧭 基线漂移检测：捕获经批准的MCP组件并检测地毯拉扯攻击
  • 📊 全面报道：生成具有可操作结果的JSON和Markdown报告
  • 📜 审计跟踪：有时间戳的基线和报告，以实现变更和发现的完全可追溯性

🧰 安装

pip install mcp-armor

🏃 快速开始

# Scan all configurations with security analysis (auto-detects baseline.json if present)
mcp-armor scan

# Inspect configurations and generate baseline (defaults to baseline.json)
mcp-armor inspect

# Use custom configuration file
mcp-armor scan --config /path/to/config.json

# Scan multiple configuration files
 mcp-armor scan \
   --config /path/to/cursor.mcp.json \
   --config /path/to/vscode.mcp.json

# Use custom baseline file path
mcp-armor inspect --baseline /path/to/my-baseline.json
mcp-armor scan --baseline /path/to/my-baseline.json

# Generate markdown report
mcp-armor scan --report-type md

# Save to custom file
mcp-armor scan --output my-report.json
mcp-armor scan --report-type md --output my-report.md

⚙️ 命令选项

选项 描述
--config 自定义配置文件路径（可多次使用）
--baseline 漂移检测（扫描）或创建（检查）的基线文件
--report-type {json,md} 输出格式（默认：json）
--output 自定义输出文件路径
--verbose 详细的终端输出
--show-logs 在终端中显示调试日志

🔰 安全检查

🛡️ 标准检查

  • 提示注入
  • 间接快速注射
  • 跨服务器工具阴影
  • 工具中毒
    • 工具描述、名称和参数中的提示注入
    • 工具描述、名称和参数中的命令注入
  • 工具名称不明确
  • 命令注入
  • 工具权限过大
  • 硬编码的秘密

🧭 基线检查

检测与批准的MCP组件的偏差（需要通过以下方式生成基线 inspect 模式）：

  • 拉臀攻击
    • 工具已修改
    • 资源已修改
    • 资源模板已修改
    • 提示已修改

📃 日志记录

日志会自动保存到 logs/mcp_armor.log:

# Default: logs saved to file only
mcp-armor scan

# Show logs in terminal too
mcp-armor scan --show-logs

🧪 演示

使用我们故意易受攻击的MCP服务器测试MCP Armor。有关详细信息，请参阅 演示指南.

⚡ 想要更多？

这个开源版本涵盖了静态MCP配置扫描。对于需要更深入保护的团队， Aira安保 提供了一个完整的企业平台，包括：

能力 开源 Aira平台
MCP配置扫描 ✅ ✅
提示和命令注射检测 ✅ ✅
工具中毒和阴影检查 ✅ ✅
硬编码秘密检测 ✅ ✅
运行时强制和阻止 ❌ ✅
代理行为策略执行 （有毒流量分析） ❌ ✅
技能扫描仪 （代理工作流程和能力分析） ❌ ✅
自定义安全策略 ❌ ✅
Aira仪表板 （集中可见性和警报） ❌ ✅
完全代理安全 （超越MCP——代理、工作流和技能） ❌ ✅

🚀 查看Aira在行动 体验整个平台。

🌟 社区

加入我们的Slack -一个供开发人员和安全工程师共同构建以保护AI代理的空间。

❓ 常见问题

Q： 我的源代码是共享的，还是所有内容都在本地运行？

MCP装甲完全在本地运行。检查和扫描模式分析您的MCP配置，检测与您的代理集成的MCP服务器，并直接在您的计算机上对其进行评估。快速注入检查使用我们的开源模型 Aira-security/FT-Llama-Prompt-Guard-2，从Hugging Face下载到您的本地环境，确保您的数据和代码永远不会被外部共享。

⚖️ 许可证

根据Apache 2.0许可证分发。看 许可证 了解更多信息。

相关 MCP