Kali Linux MCP

🚀 Kali_Linux_MCP

Kali_Linux_MCP 是一款用於安全測試的工具，它通過特定的服務器腳本將 Kali Linux 中的安全工具以 API 的形式暴露出來，支持通過 MCP 客戶端進行調用，可用於授權實驗、CTF 競賽、HTB/THM 機器測試等場景。

🚀 快速開始

項目概述

Kali_Linux_MCP 通過以下方式暴露 Kali 工具：

• Kali_Linux_Server.py：使用 Flask API 封裝瞭如 nmap、gobuster、nikto、sqlmap、metasploit、hydra、john、wpscan、enum4linux 等工具。
• MCP_Server.py：使用 FastMCP 的 MCP 橋接器，將 MCP 客戶端的請求轉發到 API。

本項目可用於授權實驗室、CTF 競賽、HTB/THM 機器，或通過 MCP 客戶端（如 Claude Desktop、5ire 等）進行 AI 輔助測試。

環境要求

• 需使用 Kali Linux 系統（或安裝了相關工具並將其添加到環境變量的 Linux 系統）。
• 安裝 Python 3 並安裝 flask、requests、mcp 庫。 安裝命令如下：

pip install flask requests mcp

運行步驟

1. 啟動 API：

python3 Kali_Linux_Server.py --port 5000

2. 健康檢查：

curl http://localhost:5000/health

3. 啟動 MCP 橋接器：

python3 MCP_Server.py --server http://localhost:5000 --timeout 300

📦 安裝指南

本項目的安裝主要是安裝所需的 Python 庫，具體命令如下：

pip install flask requests mcp

💻 使用示例

基礎用法

Nmap 掃描

curl -X POST http://localhost:5000/api/tools/nmap -H "Content-Type: application/json" -d '{"target":"scanme.nmap.org","additional_args":"-sV"}'

WPScan 掃描

curl -X POST http://localhost:5000/api/tools/wpscan -H "Content-Type: application/json" -d '{"url":"https://example.com","additional_args":"--enumerate u"}'

MCP 客戶端配置

添加 MCP 配置，指向：

python3 /path/to/MCP_Server.py --server http://LINUX_IP:5000

📚 詳細文檔

API 端點

• GET /health：用於檢查工具狀態。
• POST /api/command：用於運行任意命令。
• POST /api/tools/<tool>：封裝了 nmap、gobuster、dirb、nikto、sqlmap、metasploit、hydra、john、wpscan、enum4linux 等工具的調用接口。

每個請求都需要包含一個 JSON 格式的請求體，其中包含工具特定的參數（如 target、url 等）。

MCP 工具

橋接器註冊了以下 MCP 工具：nmap_scan、gobuster_scan、dirb_scan、nikto_scan、sqlmap_scan、metasploit_run、hydra_attack、john_crack、wpscan_analyze、enum4linux_scan，以及 execute_command 和 check_health。

使用場景

• 信息收集：使用 nmap_scan 映射目標服務。
• Web 枚舉：使用 gobuster_scan 或 dirb_scan。
• 漏洞排查：使用 nikto_scan、sqlmap_scan。
• WordPress 檢查：使用 wpscan_analyze。
• SMB 信息收集：使用 enum4linux_scan。
• 憑證測試（僅適用於實驗室環境）：使用 hydra_attack。
• 漏洞利用檢查：使用 metasploit_run。

🔧 技術細節

本項目主要由兩個 Python 腳本組成：

• Kali_Linux_Server.py：基於 Flask 框架構建了一個 API 服務器，將 Kali Linux 中的安全工具封裝成 API 接口，方便外部調用。
• MCP_Server.py：使用 FastMCP 作為橋接器，將 MCP 客戶端的請求轉發到 API 服務器，實現了 MCP 客戶端與 API 服務器之間的通信。

📄 注意事項

• 本項目支持 AI 輔助工作流，模型可以建議並運行命令。
• 可與 Claude Desktop、5ire 等 MCP 客戶端配合使用。
• 項目具有可擴展性，未來可以集成其他取證工具（如 Volatility、SleuthKit）。