
MCP Server for Breaking Shyet - Diclaimer - This is a DEVKIT

2025.04.03
2
Python渗透测试安全研究AI 辅助工具其它
project_astro 是一个基于 Model Context Protocol (MCP) 的服务器,旨在连接 Claude for Desktop 与 Kali Linux 安全工具,实现 AI 辅助的渗透测试。该服务器通过提供能力、提示和上下文信息,帮助 Claude 理解并有效使用 Kali Linux 工具。
View on GitHub
Overview
基本能力
产品定位
project_astro 是一个 MCP 服务器,专注于将 AI 与 Kali Linux 安全工具集成,用于渗透测试和安全研究。
核心功能
- 集成 Kali Linux 安全工具(如 nmap、gobuster、dirb、nikto、sqlmap、metasploit、hydra、john、wpscan、enum4linux)
- 提供预定义的渗透测试提示和上下文信息
- 支持 HackTheBox 环境的上下文信息
- 提供全面的调试工具
适用场景
- AI 辅助的渗透测试
- 安全研究和漏洞挖掘
- 渗透测试培训和演练
工具列表
- nmap: 网络扫描和主机发现
- gobuster: 目录和文件暴力破解
- dirb: 网页内容扫描
- nikto: 网页服务器扫描
- sqlmap: SQL 注入测试
- metasploit: 漏洞利用框架
- hydra: 密码暴力破解
- john: 密码破解
- wpscan: WordPress 漏洞扫描
- enum4linux: Windows/Samba 枚举
常见问题解答
- 依赖冲突: 确保使用虚拟环境,避免系统包冲突
- 服务器问题: 检查工具是否安装并在 PATH 中,查看服务器日志
- 安全考虑: 仅在受控环境中使用,避免未经授权的测试
使用教程
使用依赖
- Kali Linux 或其他安装安全工具的 Linux 发行版
- Python 3.8+
- Claude for Desktop
- Python 包: Flask, Requests, psutil
安装教程
选项1: 使用安装脚本(推荐)
git clone https://github.com/yourusername/kali-mcp-server.git
cd kali-mcp-server
./setup.sh
选项2: 手动安装
git clone https://github.com/yourusername/kali-mcp-server.git
cd kali-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
chmod +x mcp_server.py kali_api_server.py run.py
确保安装 Kali Linux 工具:
sudo apt update
sudo apt install nmap gobuster dirb nikto sqlmap metasploit-framework hydra john wpscan enum4linux
调试方式
使用调试模式运行:
./run.py --debug
调试端点:
- http://localhost:8080/debug/status
- MCP 服务器状态
- http://localhost:5000/debug/status
- API 服务器状态
- http://localhost:8080/debug/config
- MCP 服务器配置
- http://localhost:5000/debug/tool-test
- 测试工具是否工作
- http://localhost:8080/debug/test-api
- 测试 MCP-API 连接
- http://localhost:8080/debug/history
- 请求历史记录
健康检查:
- http://localhost:8080/health
- MCP 服务器健康检查
- http://localhost:5000/health
- API 服务器健康检查