# MCP-Kali-Server

将 Kali Linux VM 的能力通过 MCP 暴露给 Claude Code 的 API 桥。包含 Kali 侧命令执行服务端（`server.py`）和 MCP 网关客户端（`client.py`），配合 `execute_command` 可执行 Kali 上任意工具。

## 架构

```
Claude Code
   │  stdio (client.py)
   ▼
client.py ──HTTP──► server.py (Kali VM, 127.0.0.1:5000)
                        │  subprocess
                        ▼
                  Kali 工具 (nmap/masscan/impacket...)
```

- `server.py`：跑在 Kali VM，Flask HTTP API，执行命令并返回结构化结果
- `client.py`：MCP 网关，把工具调用转发到 Kali server

## 工具面

**12 个专用 MCP 工具**：`nmap_scan` / `gobuster_scan` / `dirb_scan` / `nikto_scan` / `sqlmap_scan` / `metasploit_run` / `hydra_attack` / `john_crack` / `wpscan_analyze` / `enum4linux_scan` / `server_health` / `execute_command`

**通用 `kali_tool(tool, params)` 调度器**：走 `TOOL_SPECS` 规格表，覆盖 57 工具——

| 类别 | 工具 |
|------|------|
| 侦察 | masscan / netdiscover / theharvester / whatweb / wafw00f / dnsrecon / dnsenum / fierce / amass / subfinder / httpx / dig / whois / dnsx |
| Web/目录 | ffuf / wfuzz / dirsearch / feroxbuster / nuclei / commix / joomscan / arjun |
| 服务枚举 | smbclient / smbmap / rpcclient / nbtscan / ldapsearch / snmpwalk / onesixtyone / nmblookup |
| 利用/凭据 | msfvenom / searchsploit / hashcat / responder / netexec / secretsdump / hashid / ncrack / cewl |
| AD/横向 | psexec / wmiexec / ntlmrelayx / evil-winrm / xfreerdp / bloodhound |
| 流量 | tcpdump / tshark / ngrep / arpspoof / tcpflow |
| 取证 | binwalk / exiftool / steghide / foremost |
| 无线 | aircrack-ng / airmon-ng / reaver |
| 后渗透 | proxychains |

每个工具都支持 `additional_args` 透传，配合 `execute_command` 可覆盖 Kali 全能力。

## 本版增强功能

- **通用工具调度器**：`TOOL_SPECS` 规格表 + `/api/tools/run`，一行规格加一个工具，无需逐个写 wrapper
- **自动 sudo**：需要 root 的工具（masscan/arp-scan/tcpdump/无线类）自动加 `sudo -n`（`SUDO_TOOLS`），前提是 Kali 侧已配 NOPASSWD sudo
- **每请求超时**：请求体可带 `timeout` 字段（秒）覆盖默认 180s；`execute_command(command, timeout=)` / `kali_tool(..., params={"timeout": ...})` 均已支持，超时返回 `timed_out:true` 及部分结果
- **参数校验**：缺失必需参数/未知工具返回明确错误

## 使用

### 1. Kali 侧启动 server

```bash
python3 server.py --ip 0.0.0.0 --port 5000
```

### 2. 注册 MCP client

Claude Code 项目级 `.mcp.json`（将 `<YOUR_KALI_IP>` 替换为 Kali 实际 IP）：

```json
{
  "mcpServers": {
    "kali": {
      "type": "stdio",
      "command": "python",
      "args": ["/absolute/path/to/MCP-Kali-Server/client.py", "--server", "http://<YOUR_KALI_IP>:5000/"]
    }
  }
}
```

客户端通过 HTTP 直连 Kali server（NAT/桥接均可），无需 SSH 隧道；改 IP 只动 `.mcp.json` 一处。

### 3. 调用示例

```python
# 专用工具
mcp__kali__nmap_scan(target="10.0.0.1", scan_type="-sV")

# 通用调度器
mcp__kali__kali_tool(tool="masscan", params={"target": "10.0.0.0/24", "ports": "80,443"})

# 任意命令
mcp__kali__execute_command(command="whoami", timeout=600)
```

## 部署

- 部署到 Kali：`scp server.py kali@<YOUR_KALI_IP>:/home/kali/kali-mcp-server.py`（或直接 `git clone` 后运行）
- 客户端在本机：`pip install -r requirements.txt` 后用 `python client.py --server http://<YOUR_KALI_IP>:5000/` 启动
- 含对上游 `Wh0am123/MCP-Kali-Server` 的针对性增强（通用调度器/超时/sudo）

## 免责声明

仅供授权测试、CTF、安全教育使用。VM 快照可回溯，故本适配未做安全加固（含 `execute_command` 任意命令）。