AI导哈

渗透测试工具MCP服务器

一个用于渗透测试工具的MCP服务器，支持与Claude Desktop等LLM客户端集成，提供目录扫描、漏洞扫描、API测试等功能。

  • by ch1nhpd
  • Python
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 ch1nhpd/Pentest-Tools-MCP-Server

使用说明

最重要的工具MCP服务器

用于渗透测试工具的MCP（模型上下文协议）服务器，旨在与各种LLM客户端（如Claude Desktop、Roo Code和其他兼容的MCP客户端）配合使用。

特性

  • 全面的渗透测试工具：
    • 目录扫描（FFuf、Dirsearch）
    • 漏洞扫描（Nuclei、XSStrike）
    • API测试
    • 侦察
    • 还有更多。..
  • SecLists中的预配置单词表
  • 自动生成报告
  • Claude桌面集成

先决条件

  • Docker和Docker Compose（用于容器化设置）
  • Claude Desktop应用程序或其他MCP兼容客户端
  • Python 3.10+和uv（用于本地设置）

目录设置

  1. 创建所需的目录：
# Create directories
mkdir -p reports templates wordlists
  1. 目录结构应该如下：
pentest-tools/
├── reports/          # For storing scan reports
├── templates/        # For report templates
├── wordlists/        # For custom wordlists
├── pentest-tools-mcp-server.py
├── config.json
├── requirements.txt
├── docker-compose.yml
└── Dockerfile

设置

Docker安装程序（推荐）

  1. 构建并启动容器：
docker-compose up -d --build
  1. 验证容器是否正在运行：
docker-compose ps
  1. 必要时检查日志：
docker-compose logs -f

本地设置

  1. 安装依赖项：
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
  1. 安装所需的系统工具（例如Ubuntu/Debian）：
sudo apt-get install nmap whatweb dnsrecon theharvester ffuf dirsearch sqlmap

Claude桌面集成

  1. 配置Claude桌面：

窗户：

%APPDATA%\Claude\claude_desktop_config.json

MacOS/Linux：

~/Library/Application Support/Claude/claude_desktop_config.json
  1. 添加服务器配置：

对于Docker设置：

{
    "mcpServers": {
        "pentest-tools": {
            "command": "docker-compose",
            "args": [
                "run",
                "--rm",
                "pentest-tools",
                "python3",
                "pentest-tools-mcp-server.py"
            ],
            "cwd": "\\Path\\to\\pentest-tools"
        }
    }
}

如果上述配置在Windows上不起作用，请尝试以下替代方法：

{
    "mcpServers": {
        "pentest-tools": {
            "command": "cmd",
            "args": [
                "/c",
                "cd /d \\path\\to\\pentest-tools && docker-compose run --rm pentest-tools python3 pentest-tools-mcp-server.py"
            ]
        }
    }
}

注意事项 cwd （当前工作目录）：

  • cwd 告诉Claude Desktop从哪个目录运行命令
  • 它必须是包含以下内容的目录的绝对路径 docker-compose.yml
  • 在Windows上，使用双反斜杠(\\)在路径
  • 在Linux/MacOS上，使用正斜杠(/)
  1. 重新启动克劳德桌面

用法

Claude Desktop中的可用命令：

  1. 侦察：
/recon example.com
  1. 目录扫描：
/scan example.com --type directory
  1. 漏洞扫描：
/scan example.com --type full
/scan example.com --type xss
/scan example.com --type sqli
/scan example.com --type ssrf
  1. API测试：
/scan api.example.com --type api

自然语言命令：

  • “在example.com上运行完整的安全扫描”
  • “检查example.com上的XSS漏洞”
  • “在example.com上执行侦察”

目录结构详细信息

pentest-tools/
├── reports/            # Scan reports directory
│   ├── recon/         # Reconnaissance reports
│   ├── vulns/         # Vulnerability scan reports
│   └── api/           # API testing reports
├── templates/          # Report templates
│   ├── recon.html     # Template for recon reports
│   ├── vuln.html      # Template for vulnerability reports
│   └── api.html       # Template for API test reports
├── wordlists/         # Custom wordlists
│   ├── SecLists/     # Cloned from SecLists repo
│   ├── custom/       # Your custom wordlists
│   └── generated/    # Tool-generated wordlists
├── pentest-tools-mcp-server.py # Main MCP server
├── config.json        # Tool configuration
├── requirements.txt   # Python dependencies
├── docker-compose.yml # Docker configuration
└── Dockerfile        # Container definition

安全说明

  • 始终确保您有扫描目标的权限
  • 保持工具和依赖项的更新
  • 仔细检查扫描结果
  • 遵循负责任的披露做法

相关 MCP