JinDaGe - kali-docker-mcp MCP Details

article

README

🚀 Kali MCP Server

Kali MCP Server 是一个模型上下文协议（MCP）服务器，它在容器化的 Kali Linux 环境中提供命令执行功能，可用于半自动化渗透测试和安全研究。

🚀 快速开始

启动容器：
```
docker compose up --build -d
```
验证容器是否正在运行：
```
docker ps | grep kali-mcp-server
```

配置 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 的实际运行情况

⚠️ 免责声明

本工具仅用于教育和授权的安全测试目的。使用时风险自担。作者不对本软件的任何滥用或损坏负责。在进行安全评估之前，请始终确保您已获得适当的授权。

kali-docker-mcp