Kali Docker MCP

🚀 Kali MCP Server

Kali MCP Server 是一個模型上下文協議（MCP）服務器，它在容器化的 Kali Linux 環境中提供命令執行功能，可用於半自動化滲透測試和安全研究。

🚀 快速開始

1. 啟動容器：

   docker compose up --build -d
   

2. 驗證容器是否正在運行：

   docker ps | grep kali-mcp-server
   

3. 配置 MCP 客戶端：

   ⚠️ 重要提示

   禁用 MCP 客戶端中任何內置的終端或命令執行工具，以防止命令意外地在主機系統而非 Kali 容器中執行。為確保安全和隔離，所有安全工具應僅在容器化環境中運行。

   Claude Desktop：

   claude mcp add --transport stdio kali-mcp-server "docker exec -i kali-mcp-server python3 /app/kali_server.py"
   

   Gemini CLI：

   gemini mcp add kali-mcp-server "docker exec -i kali-mcp-server python3 /app/kali_server.py"
   

   VS Code (Copilot)： 在工作區中創建或編輯 .vscode/mcp.json：

   {
       "servers": {
           "kali-mcp-server": {
               "type": "stdio",
               "command": "docker",
               "args": [
                   "exec",
                   "-i",
                   "kali-mcp-server",
                   "python3",
                   "/app/kali_server.py"
               ]
           }
       }
   }
   

   其他客戶端：

   {
       "mcpServers": {
           "kali-mcp-server": {
               "type": "stdio",
               "command": "docker",
               "args": [
                   "exec",
                   "-i",
                   "kali-mcp-server",
                   "python3",
                   "/app/kali_server.py"
               ],
               "env": {}
           }
       }
   }
   

   配置完成後：重啟 MCP 客戶端以加載 Kali MCP 服務器。

✨ 主要特性

• 容器化命令執行：在容器化環境中運行 Kali Linux 安全工具。
• 後臺作業管理：長時間運行的命令（>60 秒）會自動作為後臺作業運行。
• Interactsh 集成：用於檢測盲漏洞的帶外交互檢測。
• 服務 API 管理：對偵察 API（如 GitHub、Shodan 等）進行集中配置。
• 工作區管理：為滲透測試工件提供有組織的目錄結構。

📦 安裝指南

要求

• Docker 與 Docker Compose
• 兼容 MCP 的客戶端（Claude Code、Gemini CLI、帶有 Copilot 的 VS Code 等）

💻 使用示例

可用工具

核心 MCP 工具

• run_kali_command - 在 Kali 環境中執行命令
• get_job_status - 檢查後臺作業狀態
• list_background_jobs - 列出所有正在運行的作業
• cancel_job - 取消正在運行的作業
• get_workspace_info - 獲取工作區配置

Interactsh 工具

• start_interactsh - 啟動帶外交互監控
• get_interactsh_status - 檢查 Interactsh 工作進程狀態
• poll_interactsh - 檢索記錄的交互信息
• stop_interactsh - 停止 Interactsh 工作進程

服務管理

• get_service_tokens - 獲取已配置的 API 服務令牌

預安裝的安全工具

• 網絡掃描：nmap、masscan
• Web 測試：dirb、ffuf、whatweb、nikto
• DNS/域名：dig、whois、dnsrecon
• 實用工具：curl、wget、jq、exiftool
• 字典文件：Seclists

📚 詳細文檔

配置

編輯 config.toml 以進行以下配置：

• 工作區目錄結構
• Interactsh 設置
• API 服務令牌（如 GitHub、Shodan、VirusTotal 等）

安全注意事項

• 容器以安全工具所需的權限運行。
• 網絡工具需要提升的能力（NET_ADMIN、NET_RAW）。
• 所有命令執行都在 Docker 環境中進行。
• 在生產環境中應安全配置 API 令牌。

📄 許可證

本項目是一個獨立的開源貢獻，與 OffSec 或 Kali Linux 沒有關聯、未得到其認可或與之相關。Kali Linux 是 Offensive Security 的商標。

🔍 演示

https://github.com/user-attachments/assets/demo.mp4

觀看 Kali MCP Server 的實際運行情況

⚠️ 免責聲明

本工具僅用於教育和授權的安全測試目的。使用時風險自擔。作者不對本軟件的任何濫用或損壞負責。在進行安全評估之前，請始終確保您已獲得適當的授權。