mcpfuzz (8endit)

麦克普夫兹

MCP服务器的动态安全测试。

现有工具扫描哪些MCP服务器 *声称* mcpfuzz测试它们 *实际上* 同上

静态扫描仪读取工具说明。mcpfuzz连接、发送精心编制的输入，并验证您的服务器是否安全地处理它们。

安装

pip install -e .

快速开始

# Scan a local MCP server (stdio transport)
mcpfuzz scan --stdio "python my_server.py"

# Discovery only (list tools, no testing)
mcpfuzz discover --stdio "python my_server.py"

# Run specific patterns only
mcpfuzz scan --stdio "python my_server.py" --patterns path_traversal,ssrf

# JSON output for CI/CD
mcpfuzz scan --stdio "python my_server.py" --format json --output report.json

# Markdown report
mcpfuzz scan --stdio "python my_server.py" --format md --output report.md

它测试了什么

mcpfuzz附带了7种安全测试模式：

运作原理

1. 连接 通过stdio（子进程）或HTTP连接到MCP服务器
2. 发现 所有工具及其参数模式通过 tools/list
3. 匹配 基于参数名称和类型的适用测试模式工具
4. 执行 通过以下方式为每个工具制作有效载荷 tools/call
5. 分析 脆弱性指标的应对措施
6. 报告 严重程度、证据和评分结果

模式匹配

mcpfuzz自动确定针对哪些工具运行哪些模式：

• 一个带有 path 参数获取路径遍历测试
• 一个带有 url 参数获取SSRF测试
• 一个带有 cmd 参数获取命令注入测试
• 针对所有工具运行输入验证、错误泄漏和资源耗尽

使用Docker安全运行（推荐）

mcpfuzz向MCP服务器发送精心编制的有效载荷。如果服务器易受攻击，则这些有效负载将在运行服务器的机器上执行。 始终在隔离的Docker容器中运行扫描 --永远不要在主机系统上。

# Build the container
docker compose build

# Scan demo servers (fully isolated — no network, no host access)
docker compose run --rm scan-vulnerable
docker compose run --rm scan-secure

# Run tests inside container
docker compose run --rm test

# Scan your own server (mount read-only)
docker compose run --rm -v /path/to/server:/target:ro scan-custom \
  scan --stdio "python /target/server.py"

容器运行时：

• network_mode: none --无网络访问
• read_only 文件系统+ tmpfs 用于温度传感器
• 所有Linux功能都下降了(cap_drop: ALL)
• no-new-privileges --无特权升级
• 内存/CPU/PID限制--杀死失控进程
• 容器内的非root用户

演示服务器

包括两个演示服务器用于开发和测试：

# Via Docker (recommended)
docker compose run --rm scan-vulnerable
docker compose run --rm scan-secure

# Direct (only for development, NOT for untrusted servers)
mcpfuzz scan --stdio "python demo_servers/vulnerable_server.py"
mcpfuzz scan --stdio "python demo_servers/secure_server.py"

添加自定义图案

看 docs/ADDING_PATTERNS.md 了解如何编写自己的YAML测试模式。

已知限制

• 回显假阳性：在响应中回应用户输入的工具（例如。， search_db return“找到0个结果： “）当输入包含检测标记时，可能会触发命令注入误报。
• 平台特定有效载荷：路径遍历有效载荷是平台感知的（Unix vs Windows），但可能存在一些跨平台边缘情况。
• 连接器：需要 aiohttp （不包括在基础依赖关系中）。单独安装： pip install aiohttp.

发展

pip install -e ".[dev]"
pytest tests/ -v

许可证

麻省理工学院