内容
# 网络大师 MCP 服务器 v1.0
## AI 赋能的网络安全自动化平台
**155 种安全工具** | **AI 赋能** | **MCP 兼容**
---
## 目录
1. [这是什么？](#这是什么)
2. [功能](#功能)
3. [系统需求](#系统需求)
4. [安装](#安装)
5. [设置指南](#设置指南)
6. [使用方法](#使用方法)
7. [可用工具](#可用工具)
8. [配置](#配置)
9. [故障排除](#故障排除)
10. [常见问题](#常见问题)
---
## 这是什么？
网络大师 MCP 服务器是一款完整的安全工具包，与 Claude、ChatGPT 或 VS Code Copilot 等 AI 助手配合使用。它提供了 155+ 种安全工具，您可以通过自然语言控制这些工具。
**示例：**
- 您：”扫描 example.com 的开放端口“
- AI：使用 nmap_scan 工具扫描目标
- 您：”检查 SQL 注入漏洞“
- AI：使用 sqlmap_scan 工具测试目标
---
## 功能
- **155 种安全工具** - 网络、网页、云端、 二进制分析
- **AI 集成** - 与 Claude Desktop、VS Code Copilot、Cursor 合作
- **网站克隆器** - 克隆网站以防检测
- **漏洞悬赏工作流** - 自动侦察和测试
- **实时监控** - 实时进程仪表盘
- **智能缓存** - 更快的重复扫描
- **错误恢复** - 自动重试和回退
---
## 系统需求
### 最低要求
- **操作系统：** Linux（Ubuntu 20.04+）、macOS 12+ 或 Windows 10+
- **内存：** 8GB 最低（推荐 16GB）
- **存储：** 10GB 空闲空间
- **Python：** 3.8 或更高
- **互联网：** 需要用于工具下载和扫描
### 推荐配置
- **Kali Linux** - 所有工具预安装
- **内存：** 32GB 用于完整扫描
- **CPU：** 4+ 个核心用于并行扫描
---
## 安装
### 步骤 1：克隆仓库
```bash
# 打开终端并导航到所需位置
cd ~/Desktop
# 克隆仓库
git clone https://github.com/your-username/cyber-master.git
# 进入目录
cd cyber-master
```
### 步骤 2：创建虚拟环境
```bash
# 创建虚拟环境
python3 -m venv cyber-env
# 激活它（Linux/Mac）
source cyber-env/bin/activate
# 激活它（Windows）
# cyber-env\Scripts\activate
```
### 步骤 3：安装依赖项
```bash
# 安装 Python 包
pip install -r requirements.txt
```
### 步骤 4：安装安全工具
```bash
# 在 Kali Linux 上（大多数工具已预安装）
sudo apt update && sudo apt install -y \
nmap masscan rustscan amass subfinder nuclei nikto \
gobuster feroxbuster ffuf dirb dirsearch httpx katana \
sqlmap wpscan hydra john hashcat ghidra radare2 gdb \
binwalk volatility3 prowler trivy
# 在 Ubuntu/Debian 上
sudo apt update && sudo apt install -y nmap nikto sqlmap hydra
```
### 步骤 5：验证安装
```bash
# 检查工具是否安装
which nmap
which nuclei
which gobuster
# 应返回路径，如 /usr/bin/nmap
```
---
## 设置指南
### 步骤 1：启动服务器
```bash
# 确保虚拟环境已激活
source cyber-env/bin/activate
# 启动 MCP 服务器
python3 cyber_master_server.py
# 您应该看到：
# ✅ CyberMaster AI MCP 服务器已启动
# 📊 端口：8888
```
### 步骤 2：测试服务器健康状况
```bash
# 打开新终端并测试
curl http://localhost:8888/health
# 应返回包含服务器状态的 JSON
```
### 步骤 3：配置 AI 客户端
#### 对于 Claude Desktop：
1. 打开 Claude Desktop
2. 进入设置 > MCP 服务器
3. 添加新服务器并配置：
```json
{
"mcpServers": {
"cyber-master": {
"command": "python3",
"args": [
"/full/path/to/cyber-master/cyber_master_mcp.py",
"--server",
"http://localhost:8888"
],
"timeout": 300
}
}
}
```
#### 对于 VS Code Copilot：
1. 打开 VS Code
2. 进入设置（Ctrl+,）
3. 搜索“MCP”
4. 添加服务器配置：
```json
{
"servers": {
"cyber-master": {
"type": "stdio",
"command": "python3",
"args": [
"/full/path/to/cyber-master/cyber_master_mcp.py",
"--server",
"http://localhost:8888"
]
}
}
}
```
### 步骤 4：重启 AI 客户端
关闭并重新打开您的 AI 客户端（Claude Desktop 或 VS Code）。
### 步骤 5：验证连接
询问您的 AI 助手：
```
"您可以检查 Cyber Master 服务器的健康状况吗？"
```
如果连接成功，它将使用 server_health 工具。
---
## 使用方法
### 基本用法
1. **启动服务器：**
```bash
cd cyber-master
source cyber-env/bin/activate
python3 cyber_master_server.py
```
2. **打开您的 AI 助手**（Claude Desktop、VS Code Copilot 等）
3. **开始提问：**
### 示例命令
#### 网络扫描
```
"使用 nmap 扫描 192.168.1.1 的开放端口"
"对 example.com 进行全面扫描"
"对 10.0.0.1 进行快速端口扫描"
```
#### Web 应用程序测试
```
"检查 example.com 是否存在 SQL 注入漏洞"
"扫描 target.com 是否存在 XSS 漏洞"
"查找 website.com 的隐藏目录"
"测试 api.target.com 是否存在命令注入"
```
#### 漏洞评估
```
"使用 nuclei 对 target.com 进行漏洞扫描"
"检查 server.com 是否存在常见配置错误"
"扫描目标系统中的已知 CVE"
```
#### 网站克隆
```
"克隆 example.com 网站及其所有资产"
"创建 login.example.com 的钓鱼模拟"
"克隆 target.com，深度为 2，并下载资产"
```
#### 漏洞悬赏工作流
```
"为 target.com 启动漏洞悬赏侦察工作流"
"查找 example.com 的所有子域名"
"枚举 api.target.com 的参数"
```
#### 二进制分析
```
"分析此二进制文件是否存在漏洞"
"检查此 ELF 二进制文件是否存在安全保护措施"
"查找此二进制文件中的 ROP 小工具"
```
#### 云安全
```
"审计我的 AWS 账户是否存在安全问题"
"扫描我的 Kubernetes 集群是否存在漏洞"
"检查我的 Docker 镜像是否存在 CVE"
```
---
## 可用工具
### 网络工具（25+）
- `nmap_scan()` - 端口扫描
- `rustscan_fast_scan()` - 超快速端口扫描
- `masscan_high_speed()` - 高速端口扫描
- `autorecon_comprehensive()` - 全面侦察
- `amass_scan()` - 子域名枚举
### Web 工具（40+）
- `nuclei_scan()` - 漏洞扫描
- `nikto_scan()` - Web 服务器扫描
- `sqlmap_scan()` - SQL 注入测试
- `gobuster_scan()` - 目录枚举
- `ffuf_scan()` - Web 模糊测试
- `wpscan_analyze()` - WordPress 扫描
### 二进制工具（25+）
- `ghidra_analysis()` - 逆向工程
- `radare2_analyze()` - 二进制分析
- `gdb_peda_debug()` - 调试
- `checksec_analyze()` - 安全检查
### 云工具（20+）
- `prowler_scan()` - AWS 安全
- `trivy_scan()` - 容器扫描
- `kube_hunter_scan()` - Kubernetes 测试
### 漏洞悬赏工具（20+）
- `bugbounty_reconnaissance_workflow()` - 全面侦察
- `bugbounty_vulnerability_hunting()` - 漏洞猎取
- `bugbounty_osint_gathering()` - OSINT 收集
---
## 配置
### 服务器配置
编辑 `cyber-master-mcp.json`:
```json
{
"mcpServers": {
"cyber-master": {
"command": "python3",
"args": [
"/path/to/cyber_master_mcp.py",
"--server",
"http://localhost:8888"
],
"timeout": 300
}
}
}
```
### 服务器选项
```bash
# 在不同端口启动
python3 cyber_master_server.py --port 9000
# 以调试模式启动
python3 cyber_master_server.py --debug
# 同时启动
python3 cyber_master_server.py --port 9000 --debug
```
### 环境变量
```bash
# 设置自定义端口
export CYBERMASTER_PORT=9000
# 设置自定义主机
export CYBERMASTER_HOST=0.0.0.0
# 设置日志级别
export CYBERMASTER_LOG=DEBUG
```
---
## 故障排除
### 问题：服务器无法启动
**解决方案：**
```bash
# 检查 Python 版本
python3 --version
# 应为 3.8 或更高
# 检查端口是否被占用
netstat -tlnp | grep 8888
# 如有必要，杀死现有进程
kill -9 <PID>
```
### 问题：工具未找到
**解决方案：**
```bash
# 检查工具是否安装
which nmap
# 安装缺失的工具
sudo apt install nmap
# 检查 PATH
echo $PATH
```
### 问题：AI 客户端无法连接
**解决方案：**
1. 验证服务器正在运行：
```bash
curl http://localhost:8888/health
```
2. 检查 MCP 配置路径是否正确
3. 重启 AI 客户端
4. 检查服务器日志中的错误
### 问题：权限被拒绝
**解决方案：**
```bash
# 使脚本可执行
chmod +x cyber_master_server.py
chmod +x cyber_master_mcp.py
# 检查文件权限
ls -la
```
### 问题：性能缓慢
**解决方案：**
```bash
# 使用更快的扫描配置文件
python3 cyber_master_server.py --debug
# 检查系统资源
htop
# 减少并发扫描
# 编辑服务器配置以限制线程
```
---
## 常见问题
### 问：我可以在 Windows 上使用它吗？
**答：** 可以，但 Kali Linux 推荐用于完整功能。在 Windows 上，请使用 WSL2。
### 问：我需要安装所有 155 种工具吗？
**答：** 不需要。从核心工具（nmap、nuclei、gobuster）开始。根据需要安装其他工具。
### 问：这是否合法？
**答：** 仅在您拥有或有权测试的系统上使用。未经授权的测试是非法的且不道德的。
### 问：我可以在没有 AI 的情况下运行它吗？
**答：** 可以。您可以直接使用 Python API。请参阅源代码中的示例。
### 问：如何更新？
**答：**
```bash
cd cyber-master
git pull
pip install -r requirements.txt
```
### 问：我可以贡献吗？
**答：** 可以！Fork 仓库并提交拉取请求。
---
## 安全通知
⚠️ **重要：**
- 仅在您拥有或有权测试的系统上使用
- 未经授权的扫描是非法的且不道德的
- 在进行测试前始终获得书面许可
- 在隔离的实验室环境中使用进行学习
- 遵循发现的漏洞的负责任披露
---
## 支持
- **作者：** Nikhil Gupta
- **电子邮件：** nikhilguptaji8@gmail.com
- **GitHub：** https://github.com/your-username/cyber-master
---
## 许可证
本项目仅用于教育和授权的安全测试目的。
