AI导哈

MCP安全扫描工具

一个基于LangGraph ReAct架构的MCP安全扫描工具，用于自动化检测MCP服务的安全漏洞，支持多种攻击检测和智能Payload生成。

  • by anntsmart
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 anntsmart/MCP-Security-Scanner

使用说明

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-693xxxxxxxxxxxxx

2. 查询进度

输入“继续”：

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

免责声明

本工具仅用于授权的安全测试。请勿用于未经授权的系统。使用者需自行承担使用本工具的所有风险和责任。

相关 MCP