AI导哈

安全测试框架

MCP Security Framework (MCPSF) 是一个专业的模型上下文协议（MCP）服务器安全测试框架，提供自动沙盒隔离、多源支持和多种安全检测器，适用于MCP服务器的安全评估和漏洞检测。

  • by JoKFA
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 JoKFA/MCP-Security-Framework

使用说明

MCP安全框架（MCPSF）

版本： 0.4.0 状态： 生产就绪

模型上下文协议（MCP）服务器的专业安全测试框架

快速开始

安装（两个选项）

选项1：直接使用（建议大多数用户使用）

git clone https://github.com/JoKFA/MCP-Security-Framework
cd MCP-Security-Framework
pip install -r requirements.txt

# Run assessments
python mcpsf.py assess <source>

选项2：可编辑安装（适用于贡献者/开发人员）

git clone https://github.com/JoKFA/MCP-Security-Framework
cd MCP-Security-Framework
pip install -e .  # Installs in editable mode

# Run assessments
python mcpsf.py assess <source>

有什么区别？

  • 选项1：仅安装requirements.txt中的依赖项
  • 选项2：以可编辑模式安装软件包（代码更改立即生效，无需重新安装）

特性

  • ✅ 自动装箱 -基于Docker的零配置隔离（AMSAW v2）
  • ✅ 多源支持 -npm包、GitHub仓库、本地目录、远程URL
  • ✅ 14安全探测器 -OWASP MCP服务器十大覆盖范围
  • ✅ 专业报告 -JSON、SARIF（GitHub安全）、CLI输出

建筑

自动沙盒和测试MCP服务器的5阶段管道：

  1. Discovery发动机 -基于AST检测来自任何来源的MCP服务器
  2. 集装箱供应器 -Docker配置，具有崩溃恢复和自动修复功能
  3. 通用桥接 -传输标准化（stdio/SSE→ HTTP)
  4. 安全评估 -14个漏洞检测器，准确率超过95%
  5. 报告生成 -多格式输出（JSON、SARIF、CLI、审计日志）

关键创新： AMSAW v2（自动MCP沙盒和包装器）可以在零手动配置的情况下测试任何MCP服务器。

使用示例

# Assess a local vulnerable MCP
python mcpsf.py assess targets/vulnerable/dv-mcp/challenges/easy/challenge1

# Assess an npm package
python mcpsf.py assess @modelcontextprotocol/server-time

# Assess a GitHub repository
python mcpsf.py assess https://github.com/modelcontextprotocol/servers/tree/main/src/time

# Run specific detectors
python mcpsf.py assess <source> --detectors MCP-2024-PI-001,MCP-2024-TP-001

# Custom output directory
python mcpsf.py assess <source> -o ./my-reports

# List all detectors
python mcpsf.py list-detectors

# Web UI for live monitoring
python mcpsf.py web

文档

📚 完整的文件

针对不同受众的详细指南：

需求

  • python 3.11+推荐（用3.11/3.12/3.13测试）
  • Node.js： 18+适用于基于节点的MCP
  • Docker： 24+拥有运行容器的权限（沙盒需要）
  • 包管理器： pip 或 uv，加 npm
  • 资源： 4+vCPU，8GB RAM，每次评估5GB可用磁盘

系统度量

度量 值
设置时间 10-20秒
评估时间 30-90秒（平均值）
成功率 100%（使用Python MCP时）
探测器 14
支持的语言 Python、Node.js
支持的交通工具 ，SSE 。

安全模型

所有MCP服务器都在 隔离的Docker容器 与：

  • 网络隔离（桥接网络）
  • 速率限制（SafeAdapter）
  • 范围执行（策略引擎）
  • 数据编辑（自动删除敏感数据）

许可证

MIT许可证-有关详细信息，请参阅许可证文件

贡献

看 贡献.md 用于开发设置、编码标准和贡献指南。

支持

  • 问题： https://github.com/JoKFA/MCP-Security-Framework/issues
  • 文档： docs/
  • 存储库： https://github.com/JoKFA/MCP-Security-Framework

内置于❤️ MCP安全社区

相关 MCP