使用说明

🐉 Pentest MCP：自主渗透测试代理

用于自主渗透测试的生产级模型上下文协议（MCP）服务器，具有智能工具路由和“血红”HexStrike AI引擎。

� 目录

🐉 Pentest MCP：自主渗透测试代理

�🚀 概述

该项目提供了一个完全码头化的 自主渗透测试环境 通过以下方式向人工智能代理（如Claude、Cline或您自己的LLM）暴露强大的安全工具模型上下文协议（MCP）.

它集成了 Kali Linux 工具与 HexStrike AI，一个专门的进攻情报引擎，管理150多种工具，实时优化参数和策略。

✨ 特性

类别	功能
自主侦察	智能子域枚举、技术检测、攻击面映射
智能开发	将复杂任务（SQLi、XSS）自动路由到HexStrike进行深入分析
AngularJS沙盒逃脱	用于现代web框架开发的专用有效载荷
状态操作	针对多步攻击的持久会话（存储然后交付攻击）
多功能桥式电路	适用于任何符合MCP标准的客户端（Claude Desktop、VS Code/Cline、Zed）
150+安全工具	Nmap、SQLMap、Nikto、Masscan、Gobuster、Hydra等，通过HexStrike实现

🏗️ 建筑

该系统使用 统一网关 架构：

┌─────────────────┐      ┌──────────────────┐      ┌────────────────────┐
│   AI Client     │ ───▶ │   kali-mcp       │ ───▶ │   hexstrike-mcp    │
│ (Claude/Cline)  │      │   (Gateway)      │      │   (150+ Tools)     │
└─────────────────┘      └──────────────────┘      └────────────────────┘
                                │
                                ▼
                      ┌──────────────────┐
                      │  Local Kali      │
                      │  Tools (Fallback)│
                      └──────────────────┘

AI客户端 向发送请求 kali-mcp.
工具执行器 分析请求。
如果复杂（例如。， sqlmap) → 路线至 HexStrike AI 集装箱。
如果simple或HexStrike不可用→ 在Kali本地执行。

📋 先决条件

码头工人：v20.10+
Docker Compose：v2.0+
python：3.10+（用于本地测试脚本）
Git：用于克隆存储库

⚙️ 安装

步骤1：克隆存储库

git clone https://github.com/Vasanthadithya-Mundrathi/Pentest-MCP.git
cd Pentest-MCP

第二步：了解Docker基础镜像

此项目使用以下Docker镜像：

容器	基础图像	用途
`kali-mcp`	`kalilinux/kali-rolling`	MCP服务器，核心安全工具
`hexstrike-mcp`	`kalilinux/kali-rolling`	HexStrike AI引擎（150+工具）

备注：The kalilinux/kali-rolling image是Kali Linux Docker的官方最小镜像。它不包括GUI。有关更多信息，请参阅 Kali Linux Docker官方文档.

步骤3：构建并启动环境

docker-compose up -d --build

此命令构建两个容器并在后台启动它们。

步骤4：验证正在运行的容器

docker ps

您应该看到两个容器正在运行：

kali-mcp 在端口上 8000
hexstrike-mcp 在端口上 8001 （内部： 8888)

🔌 连接您的AI

克劳德桌面版

将此添加到您的 claude_desktop_config.json:

苹果电脑: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kali-mcp": {
      "command": "docker",
      "args": ["exec", "-i", "kali-mcp", "python3", "/app/stdio_bridge.py"]
    }
  }
}

Cline（VS代码扩展）

打开临床设置→ MCP服务器 选项卡。
点击“编辑MCP设置”。
粘贴上面的配置。

有关更多详细信息，请参阅 CONNECT_LOCALLY.md.

⚡ 用法

一旦连接，您的AI助手就可以访问这些工具：

工具	说明
`recon_target`	全网络和网络侦察
`web_exploit`	针对XSS/SQLi/CSTI的攻击
`run_command_sync`	快速shell命令(`ls`, `whoami`)
`start_job` / `check_job_status`	长时间运行的背景扫描

示例提示

"Use kali-mcp to scan example.com for vulnerabilities."
"Run web_recon on https://target.com and identify all parameters."
"Test https://target.com?search=test for XSS vulnerabilities."

有关完整指南，请参阅 MCP_SETUP_GUIDE.md.

📂 项目结构

Pentest-MCP/
├── README.md               # You are here
├── MCP_SETUP_GUIDE.md      # Detailed usage guide
├── CONNECT_LOCALLY.md      # AI client connection instructions
├── docker-compose.yml      # Container orchestration
├── kali/                   # Kali MCP server source
│   ├── Dockerfile
│   ├── mcp_server.py       # FastAPI MCP server
│   ├── stdio_bridge.py     # MCP stdio protocol handler
│   └── skills/             # Autonomous skill modules
│       ├── recon_skill.py
│       ├── web_recon_skill.py
│       ├── web_exploitation_skill.py
│       └── tool_executor.py  # Intelligent routing
├── hexstrike/              # HexStrike AI integration
│   └── Dockerfile
├── docs/                   # Additional documentation
└── tests/                  # Test scripts and utilities

🙏 致谢与确认

这个项目站在巨人的肩膀上：

HexStrike AI 通过 @0x4m4：“血红”攻击性情报引擎，提供150多个集成安全模块。
Kali Linux Offensive Security：行业标准渗透测试分发。
模型上下文协议（MCP）：实现人工智能工具互操作性的开放标准。
PortSwigger网络安全学院：提供用于测试和验证开发有效载荷的实验室。

⚖️ 许可与免责声明

许可证: MIT许可证

⚠️ 法律免责声明

仅用于教育和授权的渗透测试目的。

该工具专为安全专业人员、道德黑客和研究人员而设计。你对自己的行为负全部责任。未经双方事先同意，对目标使用此工具是非法的。作者对误用或可能产生的任何损害绝对不承担任何责任。

使用本软件即表示您同意：

在测试任何系统之前获得适当的授权。
遵守所有适用的地方、州、国家和国际法律。
负责任地、合乎道德地使用此工具。

内置于❤️ 通过Vasanthadithya