Pentest Tools

🚀 滲透測試工具 MCP 服務器

這是一個專為滲透測試工具設計的 Model Context Protocol (MCP) 服務器，它與各類大型語言模型（LLM）客戶端兼容，像 Claude Desktop、Roo Code 等支持 MCP 協議的客戶端都能與之適配，能為滲透測試工作提供強大助力。

🚀 快速開始

本服務器可助力你開展全面的滲透測試工作，你可以按照以下步驟進行操作。

✨ 主要特性

• 全面的滲透測試工具：
  • 目錄掃描：支持 FFuf、Dirsearch 等工具。
  • 漏洞掃描：包含 Nuclei、XSStrike 等工具。
  • API 測試：可對 API 進行全面測試。
  • 基地偵察：能開展相關的偵察工作。
  • 其他更多功能：不斷拓展的功能體系，滿足多樣需求。
• 預配置的詞典：詞典來自 SecLists，為測試提供豐富資源。
• 自動化報告生成：節省時間，提高工作效率。
• Claude Desktop 整合：實現與 Claude Desktop 的無縫對接。

📦 安裝指南

先決條件

• Docker 和 Docker Compose：用於容器化設置。
• Claude Desktop 應用程序或其他 MCP 兼容客戶端：確保與服務器的通信。
• Python 3.10+ 和 uv：用於本地設置。

目錄結構搭建

1. 創建所需的目錄：

# 創建目錄
mkdir -p reports templates wordlists

2. 目錄結構應如下所示：

pentest-tools/
├── reports/          # 用於存儲掃描報告
├── templates/        # 用於報告模板
├── wordlists/        # 用於自定義詞典
├── pentest-tools-mcp-server.py
├── config.json
├── requirements.txt
├── docker-compose.yml
└── Dockerfile

安裝配置

Docker 設置（推薦）

1. 構建並啟動容器：

docker-compose up -d --build

2. 驗證容器是否運行：

docker-compose ps

3. 如需查看日誌：

docker-compose logs -f

本地設置

1. 安裝依賴項：

uv venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate
uv pip install -r requirements.txt

2. 安裝所需的系統工具（以 Ubuntu/Debian 為例）：

sudo apt-get install nmap whatweb dnsrecon theharvester ffuf dirsearch sqlmap

Claude Desktop 整合

1. 配置 Claude Desktop：
   • Windows：

%APPDATA%\Claude\claude_desktop_config.json

- **MacOS/Linux**：

~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加服務器配置： 對於 Docker 設置：

{
    "mcpServers": {
        "pentest-tools": {
            "command": "docker-compose",
            "args": ["up"],
            "env": {
                "PORT": 5005
            }
        }
    }
}

3. 在 Claude Desktop 中添加新 MCP Server：
   • 名稱：Pentest Tools
   • 類型：MCP
   • 地址：localhost:5005

💻 使用示例

基礎用法

• 掃描目標系統：

python pentest-tools-mcp-server.py scan --target <目標地址>

• 運行滲透測試：

python pentest-tools-mcp-server.py exploit --payload <攻擊載荷>

📚 詳細文檔

目錄結構說明

pentest-tools/
├── reports/          # 掃描結果報告存儲位置
├── templates/        # 自定義報告模板文件夾
├── wordlists/        # 常用的掃描詞典庫
├── pentest-tools-mcp-server.py # 服務器主程序
├── config.json       # 工具配置文件
├── requirements.txt  # Python 依賴管理
└── docker-compose.yml# Docker 容器配置

🔧 技術細節

本服務器基於 MCP 協議開發，與多種大型語言模型客戶端進行交互。通過容器化或本地部署的方式，利用 Python 及相關工具實現全面的滲透測試功能。在運行過程中，會根據配置文件和用戶輸入的參數調用不同的工具進行掃描和測試，並生成相應的報告。

📄 許可證

文檔未提及相關許可證信息。

⚠️ 重要提示

• 總是確保你有權限掃描目標系統。
• 及時更新工具和依賴項。
• 認真審查掃描結果。
• 遵循負責任的披露規範。