MCP Pentest

🚀 MCP渗透测试 - 自动化渗透测试框架

MCP（模型上下文协议）服务器用于智能自动化渗透测试。该框架能够根据检测到的目标技术，自动进行侦察、漏洞扫描和可控的漏洞利用。

🚀 快速开始

MCP Pentest是一款强大的自动化渗透测试框架，可自动执行侦察、漏洞扫描和漏洞利用等任务。下面将介绍如何安装和使用该框架。

✨ 主要特性

🔍 侦察工具

• 端口扫描 - 全面集成Nmap，支持多种扫描模式
• 子域名枚举 - 结合证书透明度日志和DNS暴力破解
• 技术检测 - 自动进行Web技术指纹识别
• 目录暴力破解 - 智能发现目录和文件

🛡️ 漏洞评估

• Nuclei集成 - 利用模板数据库进行自动化漏洞扫描
• Nikto扫描 - 检测Web服务器漏洞
• SQLMap集成 - 进行SQL注入测试
• 自定义Web漏洞检查 - 包括XSS、目录遍历、命令注入等

⚡ 漏洞利用模块

• Metasploit集成 - 自动搜索和执行漏洞利用程序
• 自定义漏洞利用尝试 - 基于框架的特定漏洞利用
• 特定技术漏洞利用 - 根据技术栈进行有针对性的攻击
• 概念验证生成 - 自动创建概念验证

🤖 智能工作流引擎

• 自适应决策 - 由AI驱动提供下一步建议
• 基于风险的优先级排序 - 智能对漏洞进行优先级排序
• 技术感知测试 - 根据检测到的技术进行定制化测试
• 自动化工作流管理 - 按顺序执行各阶段并处理依赖关系

📊 全面报告

• 多格式报告 - 支持HTML、PDF、JSON、Markdown输出
• 执行摘要 - 提供对业务友好的风险评估
• 技术细节 - 详细描述漏洞及修复建议
• 证据收集 - 自动收集证据并进行文档记录

📦 安装指南

所需工具

确保系统已安装以下工具：

# 网络扫描
sudo apt install nmap

# Web漏洞扫描
go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest

# Web服务器扫描
sudo apt install nikto

# SQL注入测试
sudo apt install sqlmap

# 可选：Metasploit（用于高级漏洞利用）
curl https://raw.githubusercontent.com/rapid7/metasploit-omnibus/master/config/templates/metasploit-framework-wrappers/msfupdate.erb > msfinstall
chmod 755 msfinstall
sudo ./msfinstall

Node.js依赖

npm install

安装步骤

1. 克隆仓库

git clone <repository-url>
cd mcp-pentest

2. 安装依赖

npm install

3. 构建项目

npm run build

4. 配置MCP客户端 将以下内容添加到您的MCP客户端配置文件中：

{
  "mcpServers": {
    "pentest": {
      "command": "node",
      "args": ["path/to/mcp-pentest/dist/index.js"],
      "env": {}
    }
  }
}

💻 使用示例

基础用法

基础自动化渗透测试

// 全范围自动化渗透测试
await mcp.call("auto_pentest", {
  target: "example.com",
  scope: "full",
  intensity: "active"
});

高级用法

仅进行侦察

// 端口扫描
await mcp.call("nmap_scan", {
  target: "192.168.1.1",
  scan_type: "aggressive"
});

// 技术检测
await mcp.call("tech_detection", {
  url: "https://example.com"
});

// 子域名枚举
await mcp.call("subdomain_enum", {
  domain: "example.com"
});

漏洞扫描

// 使用特定模板进行Nuclei扫描
await mcp.call("nuclei_scan", {
  target: "https://example.com",
  templates: ["cves", "vulnerabilities"],
  severity: "high"
});

// SQL注入测试
await mcp.call("sqlmap_scan", {
  url: "https://example.com/login.php",
  data: "username=admin&password=test"
});

漏洞利用尝试

// 搜索Metasploit模块
await mcp.call("metasploit_search", {
  service: "Apache 2.4.41",
  platform: "linux"
});

// 尝试进行漏洞利用
await mcp.call("exploit_attempt", {
  target: "192.168.1.100",
  vulnerability: "SQL Injection",
  payload: "UNION SELECT"
});

智能下一步建议

// 获取由AI提供的建议
await mcp.call("suggest_next_steps", {
  scan_results: JSON.stringify(previousResults)
});

报告生成

// 生成全面报告
await mcp.call("generate_report", {
  target: "example.com",
  format: "html"
});

🔧 技术细节

扫描强度级别

被动扫描

• 证书透明度日志
• DNS枚举
• 头部分析
• 公共信息收集

主动扫描

• 端口扫描
• 目录暴力破解
• 漏洞扫描
• 服务枚举

激进扫描

• 全端口范围扫描
• 深度目录暴力破解
• 主动漏洞利用尝试
• 全面漏洞测试

扫描范围选项

网络范围

• 端口扫描
• 服务枚举
• 网络漏洞评估

Web范围

• Web应用程序测试
• 技术指纹识别
• Web漏洞扫描

全范围

• 全面评估
• 网络 + Web测试
• 完整攻击面分析

安全考虑

道德使用

⚠️ 重要提示

本框架仅可用于以下目的：

• 授权的渗透测试
• 获得许可的安全研究
• 对自己的系统进行测试
• 教育目的

安全特性

• 速率限制 - 自动限制请求频率
• 超时控制 - 防止长时间运行的扫描
• 范围验证 - 验证和限制目标
• 安全漏洞利用 - 进行可控和可逆的测试

法律合规

• 确保在测试前获得书面授权
• 遵守当地法律法规
• 遵循负责任的披露原则
• 记录所有测试活动

📊 示例输出

自动化渗透测试结果

{
  "workflow": {
    "target": "example.com",
    "scope": "full",
    "phases": [
      {
        "name": "reconnaissance",
        "status": "completed",
        "tools": ["nmap_scan", "subdomain_enum", "tech_detection"]
      }
    ],
    "results": {
      "reconnaissance": {
        "open_ports": [
          {"port": 80, "service": "http", "version": "Apache 2.4.41"},
          {"port": 443, "service": "https", "version": "Apache 2.4.41"}
        ],
        "technologies": [
          {"technology": "WordPress", "version": "5.8", "confidence": 95}
        ]
      },
      "vulnerabilities": [
        {
          "name": "Outdated WordPress",
          "severity": "medium",
          "description": "WordPress version 5.8 has known vulnerabilities"
        }
      ],
      "risk_score": 65,
      "threat_level": "medium"
    }
  }
}

工作流引擎

框架使用智能工作流引擎，该引擎能够：

1. 分析扫描结果 - 自动解读扫描结果
2. 做出决策 - 确定下一步测试步骤
3. 调整策略 - 根据发现的情况调整方法
4. 确定行动优先级 - 专注于高影响的漏洞
5. 生成见解 - 提供可操作的建议

决策逻辑

侦察 → 技术检测 → 漏洞评估 → 风险分析 → 漏洞利用 → 报告
     ↓              ↓                    ↓                    ↓             ↓            ↓
端口发现 → CMS/框架 → 针对性扫描 → 优先级队列 → 可控利用 → 证据收集
子域名枚举 → 版本信息 → 自定义检查 → 风险评分 → 利用尝试 → 文档记录

架构

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP客户端     │    │  MCP协议        │    │  渗透测试服务器 │
│  (Claude等)     │◄──►│   传输层        │◄──►│    (Node.js)    │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                                        │
                                               ┌─────────────────┐
                                               │ 工具集成        │
                                               │   - Nmap        │
                                               │   - Nuclei      │
                                               │   - Nikto       │
                                               │   - SQLMap      │
                                               │   - Metasploit  │
                                               └─────────────────┘

🤝 贡献代码

1. 分叉仓库
2. 创建功能分支
3. 实现更改并进行测试
4. 提交拉取请求
5. 遵循安全最佳实践

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE文件。

⚠️ 免责声明

本工具仅用于教育和授权的安全测试目的。用户有责任确保合法和道德使用。开发者不对本工具的滥用负责。

🆘 支持

• 📖 文档：Wiki
• 🐛 漏洞报告：问题跟踪
• 💬 讨论：论坛
• 📧 联系：邮箱