Unaacceptable297/kali-mcp
GitHub: Unaacceptable297/kali-mcp
一个基于 Docker 的 MCP 服务器,使 AI 助手能在隔离的 Kali Linux 容器中安全执行安全任务。
Stars: 0 | Forks: 0
# 🐉 kali-mcp - 使用 AI 帮助运行 Kali 工具
[](https://github.com/Unaacceptable297/kali-mcp)
## 🧰 是什么
kali-mcp 让 AI 助手能够在 Kali Linux Docker 环境中进行安全测试。它为助手提供一个安全、隔离的空间来运行常用的 Kali 工具,从而更方便地测试系统、检查弱点并在一个地方完成安全任务。
该项目专为 Windows 本地使用设计。你在自己的电脑上运行它,并使用 Docker 启动 Kali Linux 环境。
## 📦 你需要什么
在开始之前,请确保你已具备以下条件:
- 一台 Windows 电脑
- 电脑的管理员权限
- 网络访问
- Windows 上的 Docker Desktop
- 一个支持 MCP 的 AI 助手
- 至少 8 GB 内存
- 约 10 GB 的可用磁盘空间
如果你的系统较旧,程序仍可能运行,但 Docker 会占用大量内存。更多的内存会带来更流畅的体验。
## 🚀 下载 kali-mcp
前往以下页面下载:
[访问 kali-mcp 仓库](https://github.com/Unaacceptable297/kali-mcp)
使用该页面获取所需文件,然后按照下面的设置步骤操作。
## 🪟 在 Windows 上运行步骤
请按顺序执行以下步骤。
### 1. 安装 Docker Desktop
如果电脑上尚未安装 Docker Desktop,请先安装。
1. 打开 Docker Desktop 网站
2. 下载 Windows 版本
3. 运行安装程序
4. 如有提示,重启电脑
5. 打开 Docker Desktop 并等待其显示正在运行
Docker 负责在你电脑上启动 Kali Linux 环境。
### 2. 获取项目文件
1. 打开仓库链接
2. 将项目文件下载到电脑
3. 将其保存到容易找到的文件夹,如 `Downloads` 或 `Documents`
4. 如果文件是 ZIP 格式,右键 ZIP 文件并选择“全部提取”
完成后,你应该会得到一个名为 `kali-mcp` 的文件夹。
### 3. 打开文件夹
1. 打开文件资源管理器
2. 转到保存项目的文件夹
3. 打开 `kali-mcp` 文件夹
你应该能在该文件夹中看到项目相关文件。
### 4. 启动 Kali 环境
该项目使用 Docker 来启动 Kali Linux 容器。
1. 打开 Docker Desktop 并确保其正在运行
2. 在 `kali-mcp` 文件夹中打开命令窗口
3. 运行项目自带的启动命令
4. 等待 Docker 下载 Kali 镜像
5. 完成设置
首次启动可能需要几分钟,之后启动会更快。
### 5. 连接你的 AI 助手
当 Docker 设置完成后,连接你的 MCP 兼容 AI 助手。
1. 打开 AI 助手应用
2. 进入其 MCP 或服务器设置
3. 添加 `kali-mcp` 服务器
4. 使用项目文件中的本地路径或命令
5. 保存设置
6. 如有必要,重启助手
之后,助手即可在 Kali 环境中执行支持的安全任务。
## 🛠️ 首次使用
当服务器运行后,你可以让助手协助完成以下工作:
- 基础网络检查
- 使用 nmap 等工具进行端口扫描
- 服务检查
- 简单的安全测试
- 检查 Kali 容器中的系统信息
请确保你的使用仅限于你拥有或已获授权测试的系统。
## 🧭 常见任务
以下是人们常用 kali-mcp 的一些简单方式:
- 检查测试机器上开放了哪些端口
- 查找常见服务横幅
- 运行基础网络发现
- 测试本地实验室环境
- 在不安装完整 Kali 系统的情况下使用 Kali 工具
由于工具在 Docker 中运行,你的主 Windows 系统与测试环境是隔离的。
## ⚙️ 工作原理
kali-mcp 作为 AI 助手与 Kali Linux Docker 容器之间的桥梁。
- AI 助手发送请求
- MCP 服务器将任务传递给 Kali 容器
- 容器运行工具
- 结果返回给助手
这种设置使工作流程更简单。你无需每次手动打开 Kali。
## 🔐 安全与权限
请仅在你拥有或明确获授权测试的系统上使用此工具。安全工具可以扫描网络、检查服务并收集数据,如果使用不当,可能影响系统。
安全的设置包括:
- 你自己的电脑
- 家庭实验室
- 测试虚拟机
- 培训环境
- 你已获得书面授权的系统
## 🧪 使用示例
- 学习安全工具的工作原理
- 测试家庭实验室
- 在启动前检查小型服务器
- 探索 AI 助手如何运行命令行工具
- 在 Docker 沙箱中进行可重复的检查
## 🧱 故障排除
### Docker 无法启动
- 检查是否已安装 Docker Desktop
- 重启电脑
- 以管理员身份打开 Docker Desktop
- 确保 BIOS 或 UEFI 中已启用虚拟化
### Kali 容器运行缓慢
- 关闭其他占用资源的应用
- 在设置中为 Docker 提供更多内存
- 确保有足够的可用磁盘空间
### 助手无法看到服务器
- 检查 MCP 配置路径
- 确保服务器正在运行
- 重启 AI 助手
- 确认项目文件夹未移动
### 安装似乎卡住
- 首次运行时等待几分钟
- 检查网络连接
- 查看 Docker Desktop 是否正在拉取镜像
- 重启 Docker 后重试
## 📁 项目结构
项目文件通常包括:
- MCP 服务器文件
- Docker 配置文件
- 启动脚本
- 配置文件
- 文档
请将所有文件保持在同一文件夹中,以保持设置简单。
## 🖥️ Windows 建议
- 使用路径较短的文件夹,如 `C:\kali-mcp`
- 使用时保持 Docker Desktop 打开
- 设置完成后不要移动文件夹,除非更新路径
- 如果 Windows 请求权限,请允许 Docker 和项目文件
## 🔍 为何使用它
该项目帮助你在不设置完整虚拟机的情况下使用 Kali Linux 工具。它还能让 AI 助手协助执行需要命令行工具的任务,在实验室或测试环境中进行重复性安全检查时可以节省时间。
## 📌 仓库详情
- 名称:kali-mcp
- 类型:MCP 服务器
- 平台:Windows(使用 Docker)
- 用途:使用 Kali Linux 工具进行安全测试
- 主题:AI 工具、Claude、网络安全、Docker、道德黑客、Kali Linux、MCP、nmap、渗透测试、安全
标签:AI 助手, AI安全, Chat Copilot, DevSecOps, Docker, MCP, NIDS, PB级数据处理, Web截图, 上游代理, 安全测试, 安全运维, 安全防御评估, 容器化, 容器安全, 开源安全工具, 攻击性安全, 本地安全, 网络安全, 网络调试, 自动化, 自动化攻击, 请求拦截, 逆向工程平台, 隐私保护