MCP Security Scanner
一个基于 LangGraph ReAct 架构的 MCP (Model Context Protocol) 安全扫描工具，用于自动化检测 MCP 服务的安全漏洞。
功能特性
- 自动化安全扫描：自动发现 MCP 服务暴露的工具并进行安全测试
- 多种攻击检测：
- 命令注入 (Command Injection) - 代码执行 (Code Execution) - SQL 注入 (SQL Injection) - SSRF (Server-Side Request Forgery) - 路径遍历 (Path Traversal) - 越权访问 (IDOR) - 过度数据暴露 (Excessive Data Exposure) - 敏感业务数据泄露 - 硬编码凭据检测 - 工具描述注入
- 智能 Payload 生成：根据工具类型和参数自动生成针对性测试载荷
- 异步任务管理：支持后台扫描，实时查询进度
- 双模式扫描：
- fast 模式：快速并发扫描 - full 模式：完整 LLM 引导扫描
- 详细报告：生成包含 POC 和修复建议的安全报告
安装
pip install -r requirements.txt
推荐使用uv环境
uv init MCP
cd MCP
echo "3.13" > .python-version
uv venv
source .venv/bin/activate
uv add "mcp[cli]" httpx依赖
- Python 3.10+
- langgraph
- fastmcp
- httpx
- mcp
快速开始
启动 MCP 服务器
python main.py
使用uv安装：uv run main.py
服务器默认运行在 `http://0.0.0.0:8000/sse`使用方式
通过 MCP 客户端（如 Cherry Studio/Kiro/Cursor/Trae）连接：
{
"mcpServers": {
"Security-Scanner": {
"url": "http://10.0.xx.xx:8000/sse"
}
}
}1. 启动扫描
无Token:
对该MCP进行安全扫描
http://xxx.xxx.xxx:7777/sse有Token:
对该MCP进行安全扫描
https://xxx.xxx.xxx/mcp-servers/plant-monitor-getproductionorder/sse
Authorization=Bearer apikey-693xxxxxxxxxxxxx2. 查询进度
输入“继续”：
3. 获取结果
输入“获取扫描详情”：
项目结构
├── agent.py # ReAct 智能体实现
├── config.py # 攻击载荷和检测规则配置
├── graph.py # LangGraph 工作流定义
├── llm.py # LLM 客户端（支持通义千问/Azure OpenAI）
├── server.py # FastMCP 服务器
├── state.py # 状态定义
├── task_manager.py # 异步任务管理器
├── tools.py # 安全检测工具函数
└── system_prompt.md # 系统提示词配置
LLM 配置
在 llm.py 中配置 LLM 提供商：
- 通义千问 (默认)
- Azure OpenAI
攻击载荷
在 config.py 中自定义：
MCP_INJECTION_PAYLOADS：各类攻击载荷SENSITIVE_PATTERNS：敏感信息检测模式TOOL_TYPE_PATTERNS：工具类型识别规则
检测能力
| 漏洞类型 | 严重程度 | 说明 |
|---|---|---|
| 命令注入 | CRITICAL | 检测系统命令执行 |
| 代码执行 | CRITICAL | 检测任意代码执行 |
| SQL 注入 | HIGH | 检测数据库注入 |
| SSRF | HIGH | 检测内网资源访问 |
| 路径遍历 | HIGH | 检测文件系统访问 |
| IDOR | HIGH | 检测越权访问 |
| 数据暴露 | MEDIUM | 检测大量数据返回 |
| 敏感数据 | HIGH/CRITICAL | 检测 PII/HR/财务数据 |
| 硬编码凭据 | HIGH | 检测 Schema 中的凭据 |
输出示例
{
"status": "completed",
"target": "http://example.com/sse",
"risk_level": "HIGH",
"summary": {
"tools_discovered": 10,
"injectable_tools": 5,
"attacks_executed": 30,
"vulnerabilities_found": 3
},
"vulnerabilities_by_severity": {
"HIGH": {
"count": 2,
"details": [...]
},
"MEDIUM": {
"count": 1,
"details": [...]
}
}
}许可证
MIT License
免责声明
本工具仅用于授权的安全测试。请勿用于未经授权的系统。使用者需自行承担使用本工具的所有风险和责任。