pentestfrenzymcp

渗透测试MCP服务器

一个全面的模型上下文协议（MCP）服务器，提供专业的渗透测试工具和实用程序。此服务器与无缝集成 克劳德桌面 以及其他兼容MCP的客户端，使您可以在人工智能对话中直接访问行业标准的安全测试工具。

🛡️ 特性

网络安全工具

• Nmap扫描：具有各种扫描类型的全面端口扫描（快速、完整、隐形、UDP、版本检测、操作系统检测）
• 域名解析：查询DNS记录（A、AAAA、MX、NS、TXT、CNAME、SOA）
• WHOIS查询：域名注册和所有权信息

Web应用程序安全

• Nikto扫描：针对常见安全问题的Web漏洞扫描
• DIRB：使用单词表对目录和文件进行暴力破解
• Gobuster：快速目录、DNS和虚拟主机暴力破解

侦察与OSINT

• 转租人3r：使用多个搜索引擎（谷歌、必应、雅虎等）枚举子域

🚀 快速开始

先决条件

• 码头工人 （推荐）或Python 3.10+
• 克劳德桌面 应用

步骤1：构建MCP服务器

选项A:Docker（推荐）

# Clone the repository
git clone https://github.com/FrenzyVJN/pentestfrenzymcp
cd pentestfrenzymcp

# Build the Docker image
./build.sh

# Test the installation
./simple-test.sh

选项B：本地安装

# Install Python dependencies
pip install httpx mcp dnspython sublist3r

# Install system tools (macOS)
brew install nmap nikto dirb gobuster whois

# Install system tools (Ubuntu/Debian)
sudo apt-get update
sudo apt-get install nmap nikto dirb gobuster whois dnsutils

步骤2：配置Claude桌面

适用于macOS

1. 打开Claude Desktop配置文件：

# Create the directory if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude

# Edit the configuration file
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

1. 添加MCP服务器配置：

Docker设置（推荐）：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "pentest-mcp:latest"
      ]
    }
  }
}

本地安装：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "python3",
      "args": ["/full/path/to/pentest-mcp/main.py"],
      "cwd": "/full/path/to/pentest-mcp"
    }
  }
}

对于Windows

1. 打开Claude Desktop配置文件：

# Navigate to the Claude config directory
cd %APPDATA%\Claude

# Create/edit the configuration file
notepad claude_desktop_config.json

1. 添加MCP服务器配置：

Docker设置（推荐）：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "pentest-mcp:latest"
      ]
    }
  }
}

WSL（Linux的Windows子系统）：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "wsl",
      "args": [
        "-e",
        "docker",
        "run",
        "--rm",
        "-i",
        "--network=host",
        "pentest-mcp:latest"
      ]
    }
  }
}

本地Windows安装：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "python",
      "args": ["C:\\full\\path\\to\\pentest-mcp\\main.py"],
      "cwd": "C:\\full\\path\\to\\pentest-mcp"
    }
  }
}

步骤3：重新启动克劳德桌面

在更新配置文件之后， 完全重新启动克劳德桌面 加载新的MCP服务器。

步骤4：验证连接

1. 打开克劳德桌面
2. 开始新的对话
3. 查找MCP服务器指示器（通常是一个小图标或状态指示器）
4. 尝试一个简单的命令：“你能为google.com进行DNS查找吗？”

💬 使用示例

配置后，您可以在Claude Desktop中使用这些自然语言命令：

🔍 网络侦察

"Can you scan the top 1000 ports on scanme.nmap.org?"
"Do a quick nmap scan on 127.0.0.1"
"Perform a stealth scan on 192.168.1.1"
"Scan ports 22,80,443 on example.com with version detection"

🌐 DNS和域分析

"Look up DNS A records for google.com"
"Get all MX records for github.com"
"Do a WHOIS lookup for microsoft.com"
"Find the nameservers for cloudflare.com"

🔎 子域发现

"Find subdomains for example.com using sublist3r"
"Enumerate subdomains for target.com with bruteforce enabled"
"Discover subdomains for company.com using all search engines"

🛡️ Web应用程序测试

"Run a nikto scan on http://testphp.vulnweb.com"
"Use dirb to find directories on http://example.com"
"Perform directory brute forcing on https://target.com using gobuster"
"Scan for common web vulnerabilities on https://demo.site.com"

🎯 高级扫描场景

"Do a comprehensive security assessment of 192.168.1.100"
"Perform reconnaissance on example.com including subdomains and port scan"
"Check if port 22 is open on a list of IP addresses: 10.0.0.1, 10.0.0.2"

🛠️ 可用工具

🔧 高级配置

自动批准工具（跳过确认）

将工具添加到 autoApprove 跳过确认对话框的列表：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--network=host", "pentest-mcp:latest"],
      "autoApprove": [
        "dns_lookup",
        "whois_lookup",
        "nmap_scan"
      ]
    }
  }
}

自定义单词列表

挂载自定义单词表以进行目录暴力破解：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i", "--network=host",
        "-v", "/path/to/wordlists:/wordlists:ro",
        "pentest-mcp:latest"
      ]
    }
  }
}

环境变量

设置自定义环境变量：

{
  "mcpServers": {
    "pentest-mcp": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--network=host", "pentest-mcp:latest"],
      "env": {
        "SCAN_TIMEOUT": "30",
        "MAX_THREADS": "20"
      }
    }
  }
}

🔍 故障排除

MCP服务器未出现

1. 检查配置文件位置：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 验证JSON语法： 使用JSON验证器检查您的配置

1. 完全重新启动克劳德桌面 （不仅仅是刷新）

1. 检查Docker： 确保Docker正在运行并且映像存在：

   docker images pentest-mcp

工具不工作

1. 手动测试Docker容器：

   docker run --rm -it pentest-mcp:latest bash

1. 检查工具可用性：

   ./simple-test.sh

1. 验证网络访问： 确保 --network=host 用于扫描外部目标

权限问题

• macOS： 授予Docker访问网络资源的权限
• 窗户： 如果需要，以管理员身份运行Docker Desktop
• Linux： 将用户添加到docker组： sudo usermod -aG docker $USER

⚠️ 安全和法律考虑

🚨 重要警告

• 需要授权：仅在您拥有或有明确书面许可进行测试的系统上使用这些工具
• 遵守法律：确保遵守当地法律法规
• 责任揭秘：对发现的任何漏洞遵循负责任的披露做法
• 速率限制：尊重扫描速率，避免压倒目标系统

🔒 安全功能

• 集装箱隔离：工具在隔离的Docker容器中运行
• 无持久存储：容器每次使用后都会被销毁
• 网络隔离：用于测试的可选网络隔离
• 审计日志：记录所有工具执行情况

🏗️ 建筑

服务器采用模块化架构，便于扩展：

pentest/
├── __init__.py          # Package initialization
├── tools.py             # Tool definitions and schemas
├── handlers.py          # Tool call routing and handling
├── network.py           # Network tools (nmap, DNS, WHOIS)
├── web.py              # Web security tools (nikto, dirb, gobuster)
└── recon.py            # Reconnaissance tools (sublist3r)

添加新工具

1. 定义工具 在……里面 pentest/tools.py
2. 实现处理程序 在……里面 pentest/handlers.py
3. 创建工具类 在适当的模块中
4. 更新工具列表 在……里面 get_all_tools()

有关要遵循的示例和模式，请参阅现有工具。

🤝 贡献

欢迎投稿！拜托：

1. 遵循现有的代码模式
2. 添加全面的错误处理
3. 包括安全考虑
4. 使用Docker和本地安装进行测试
5. 更新文档

📄 许可证

此项目仅用于教育和授权的安全测试目的。用户有责任确保遵守适用法律，并在测试任何系统之前获得适当的授权。

______________________________________________________________________