内容
# Majestic AI v1.0 🔴
### 人工智能驱动的网络安全自动化平台
```
╔══════════════════════════════════════════════════════╗
║ Majestic AI v1.0 | MCP 平台 | 端口 8888 ║
╚══════════════════════════════════════════════════════╝
```
---
## 架构
```
AI 代理（Claude/GPT/Copilot）
│ MCP 协议
▼
mcp_client.py ← FastMCP 封装器（50+ 工具定义）
│ HTTP/REST
▼
server.py ← Flask API（0.0.0.0:8888）
│
├── agents.py （12 个 AI 代理类）
├── cache_engine.py （LRU 缓存 + 进程注册）
├── error_engine.py （10 种错误类型 + 重试 + 降级）
├── visual_engine.py （血红色 ANSI 终端 UI）
└── browser_agent.py （Selenium 无头 Chrome）
```
---
## 快速入门
### 1. 安装依赖
```bash
pip install -r requirements.txt
```
### 2. 启动 API 服务器
```bash
# 默认（端口 8888）
python server.py
# 自定义端口
python server.py --port 9000
# 调试模式
python server.py --debug
# 通过环境变量
set HEXSTRIKE_PORT=9000 && python server.py
```
### 3. 通过 MCP 连接 AI 代理
```bash
python mcp_client.py --server http://localhost:8888
```
### 4. 配置 Claude Desktop
复制 `claude_mcp_config.json` 内容到：
`%APPDATA%\Claude\claude_desktop_config.json`
---
## API 端点（50+）
| 类别 | 端点 |
|---|---|
| 核心 | `GET /health`, `GET /`, `GET /banner` |
| 执行 | `POST /execute`, `POST /execute/stream` |
| 进程 | `GET /processes`, `POST /processes/{pid}/pause|resume|terminate` |
| 情报 | `POST /intelligence/analyze-target`, `select-tools`, `optimize-parameters`, `create-attack-chain`, `smart-scan`, `technology-detection`, `correlate-vulnerabilities` |
| CVE | `GET /cve/lookup/{tech}`, `GET /cve/enrich/{cve_id}` |
| 利用 | `POST /exploit/generate`, `GET /exploit/templates` |
| 漏洞赏金 | `POST /bugbounty/start`, `phase-commands`, `full-recon` |
| CTF | `POST /ctf/solve`, `ctf/full-solve`, `GET /ctf/categories` |
| 浏览器 | `POST /browser/navigate|screenshot|extract-dom|cookies|security-headers|full-analysis` |
| 工具 | `POST /tools/{tool_name}`（55+ 工具） |
| 文件 | `POST /files/write`, `GET /files/read/{name}`, `GET /files/list`, `DELETE /files/{name}` |
| 可视化 | `POST /visual/progress|severity-card|table` |
| 遥测 | `GET /cache/stats`, `GET /telemetry/performance|errors|failures` |
| 系统 | `GET /system/info`, `GET /errors` |
---
## 12 个 AI 代理类
| # | 代理 | 目的 |
|---|---|---|
| 1 | `IntelligentDecisionEngine` | 排名工具，构建攻击链，成功概率 |
| 2 | `BugBountyAgent` | 协调完整的recon工作流 |
| 3 | `CTFAgent` | CTF类别求解器，工具流程 |
| 4 | `CVEIntelligenceManager` | CVE查找和丰富 |
| 5 | `AIExploitGenerator` | PoC模板（8种漏洞类型） |
| 6 | `VulnerabilityCorrelator` | 漏洞链，风险评分 |
| 7 | `TechnologyDetector` | 指纹技术，从头部/主体 |
| 8 | `RateLimitDetector` | 检测429和限速头部 |
| 9 | `FailureRecoverySystem` | 跟踪失败，建议备用 |
| 10 | `PerformanceMonitor` | 平均持续时间，每个工具的成功率 |
| 11 | `ParameterOptimizer` | 隐身/主动参数调优 |
| 12 | `GracefulDegradation` | nmap→masscan→rustscan备用链 |
---
## 漏洞赏金阶段
| 阶段 | 工具 | 超时 |
|---|---|---|
| 子域名发现 | amass, subfinder, assetfinder | 300s |
| HTTP 探测 | httpx, nuclei | 180s |
| 内容发现 | katana, gau, waybackurls, dirsearch | 600s |
| 参数发现 | paramspider, arjun, x8 | 240s |
**漏洞优先级：** RCE(10) → SQLi(9) → SSRF/IDOR(8) → XSS/LFI(7) → XXE(6) → CSRF(5)
---
## CTF 类别
`web` | `crypto` | `pwn` | `forensics` | `reversing` | `misc` | `osint` | `stego`
**PWN流程：** `checksec → gdb-peda → ropgadget → pwntools`
---
## 错误处理
10种错误类型，指数退避（立即 → 5s → 10s，3次重试）：
`TIMEOUT` | `PERMISSION_DENIED` | `NETWORK_UNREACHABLE` | `RATE_LIMITED` | `TOOL_NOT_FOUND` | `INVALID_PARAMETERS` | `RESOURCE_EXHAUSTED` | `AUTHENTICATION_FAILED` | `TARGET_UNREACHABLE` | `PARSING_ERROR`
---
## 文件
| 文件 | 描述 |
|---|---|
| `server.py` | Flask REST API，50+ 端点，0.0.0.0:8888 |
| `mcp_client.py` | AI 代理的 FastMCP 封装器 |
| `agents.py` | 12 个 AI 代理类 |
| `cache_engine.py` | LRU 缓存（1000 条目，3600s TTL） |
| `error_engine.py` | 错误分类 + 重试 + 降级 |
| `visual_engine.py` | 血红色 ANSI 终端引擎 |
| `browser_agent.py` | Selenium 无头 Chrome 代理 |
| `claude_mcp_config.json` | Claude Desktop MCP 配置（300s 超时） |
| `requirements.txt` | Python 依赖项 |
---
> ⚠️ **法律声明：** 仅限授权的安全测试、漏洞赏金计划和 CTF 竞赛。
MCP 市场