kali-mcp-server

PenTestT00ls/kali-mcp-server

3.3

If you are the rightful owner of kali-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Kali MCP project is a Model Context Protocol server based on Kali Linux, designed to provide penetration testing and security assessment tool interfaces for AI assistants.

Tools
5
Resources
0
Prompts
0

Kali MCP 项目

一个基于Kali Linux的MCP（Model Context Protocol）服务器项目，为AI助手提供渗透测试和安全评估工具接口。

项目概述

本项目包含两个主要组件：

  • kali_server.py - Kali Linux API服务器，提供工具执行接口
  • mcp_server.py - MCP协议服务器，连接AI助手与Kali工具
  • mcp.json - MCP客户端配置文件

系统架构

AI助手 (MCP客户端) ←→ mcp_server.py ←→ kali_server.py ←→ Kali Linux工具

快速开始

环境要求

  • Python 3.8+
  • Kali Linux 系统（或安装了渗透测试工具的Linux系统）
  • 网络连接（用于API通信）

安装步骤

  1. 克隆项目

    git clone <repository-url>
cd kali-mcp-server

  2. 安装依赖

    pip install -r requirements.txt

  3. 配置Kali服务器

    • 确保Kali Linux系统已安装所需工具
    • 修改kali_server.py中的配置（如API端口）

  4. 启动Kali API服务器

    python kali_server.py

    服务器将在默认端口5000启动

  5. 配置MCP客户端

    • 修改mcp.json中的服务器地址
    • 确保Python路径正确

  6. 启动MCP服务器

    python mcp_server.py --server http://your-kali-ip:5000/

文件说明

kali_server.py

Kali Linux API服务器，提供以下功能：

主要特性：

  • 命令执行管理（支持超时控制）
  • 多线程输出处理
  • 错误处理和日志记录
  • RESTful API接口

API端点：

  • POST /api/command - 执行任意命令
  • POST /api/tools/nmap - Nmap网络扫描
  • POST /api/tools/gobuster - Gobuster目录扫描
  • POST /api/tools/dirb - Dirb Web内容扫描
  • POST /api/tools/nikto - Nikto Web服务器扫描
  • POST /api/tools/sqlmap - SQLMap SQL注入检测
  • POST /api/tools/metasploit - Metasploit模块执行
  • POST /api/tools/hydra - Hydra密码破解
  • POST /api/tools/john - John the Ripper密码破解
  • POST /api/tools/wpscan - WPScan WordPress扫描
  • POST /api/tools/enum4linux - Enum4linux枚举

mcp_server.py

MCP协议服务器，提供以下工具函数：

渗透测试工具：

  • nmap_scan() - 网络端口和服务发现
  • gobuster_scan() - Web目录和文件发现
  • dirb_scan() - Web内容扫描
  • nikto_scan() - Web服务器漏洞扫描
  • sqlmap_scan() - SQL注入检测
  • metasploit_run() - Metasploit模块执行
  • hydra_attack() - 密码暴力破解
  • john_crack() - 密码哈希破解
  • wpscan_analyze() - WordPress安全扫描
  • enum4linux_scan() - Windows/Samba枚举

信息收集工具：

  • masscan_scan() - 快速端口扫描
  • zmap_scan() - 互联网范围扫描
  • unicornscan_scan() - 异步网络扫描

mcp.json

MCP客户端配置文件：

{
  "mcpServers": {
    "kali_mcp": {
      "timeout": 180,
      "type": "stdio",
      "command": "python路径",
      "args": [
        "mcp_server.py路径",
        "--server",
        "Kali服务器地址"
      ]
    }
  }
}

工具功能详解

网络扫描工具

Nmap扫描
nmap_scan(
    target="192.168.1.1",
    scan_type="-sV",
    ports="80,443,22",
    additional_args="-T4"
)
Masscan扫描
masscan_scan(
    target="192.168.1.0/24",
    ports="1-1000",
    rate="1000"
)

Web应用扫描工具

Gobuster目录扫描
gobuster_scan(
    url="http://target.com",
    mode="dir",
    wordlist="/usr/share/wordlists/dirb/common.txt"
)
SQLMap SQL注入检测
sqlmap_scan(
    url="http://target.com/login.php",
    data="username=admin&password=test",
    additional_args="--level=3 --risk=2"
)

密码攻击工具

Hydra暴力破解
hydra_attack(
    target="192.168.1.1",
    service="ssh",
    username="admin",
    password="password123"
)
John the Ripper密码破解
john_crack(
    hash_file="/path/to/hashes.txt",
    wordlist="/usr/share/wordlists/rockyou.txt"
)

📋 完整工具列表

🔍 网络扫描工具 (Network Scanners)

  • nmap - 网络发现和安全扫描
  • masscan - 大规模端口扫描
  • zmap - 快速网络扫描
  • unicornscan - 异步网络扫描
  • netdiscover - 网络主机发现
  • naabu - 快速端口扫描
  • rustscan - Rust编写的快速端口扫描
  • netcat - 网络工具瑞士军刀
  • traceroute - 路由跟踪
  • tcpdump - 网络包分析
  • wireshark - 网络协议分析
  • socat - 多用途中继工具

🌐 Web扫描工具 (Web Scanners)

  • gobuster - 目录/文件暴力扫描
  • dirb - Web内容扫描器
  • nikto - Web服务器扫描器
  • wpscan - WordPress安全扫描
  • whatweb - Web技术识别
  • wafw00f - WAF检测
  • dirsearch - Web路径扫描
  • feroxbuster - 快速内容发现
  • katana - 下一代爬虫
  • meg - 大规模URL获取
  • arjun - 参数发现
  • paramspider - 参数提取
  • waybackurls - 历史URL获取
  • gau - 获取已知URL
  • nuclei - 漏洞扫描
  • vulmap - 漏洞映射
  • joomscan - Joomla扫描
  • droopescan - Drupal扫描
  • cmsmap - CMS扫描
  • wapiti - Web应用漏洞扫描
  • arachni - Web应用安全扫描
  • skipfish - Web应用安全扫描
  • netsparker - Web安全扫描
  • ffuf - Web模糊测试
  • wfuzz - Web应用模糊测试
  • xsser - XSS漏洞扫描

🔎 枚举工具 (Enumeration Tools)

  • enum4linux - SMB枚举
  • subfinder - 子域名发现
  • amass - 攻击面映射
  • dnsrecon - DNS枚举
  • dnsenum - DNS枚举
  • fierce - DNS扫描
  • sublist3r - 子域名枚举
  • findomain - 子域名监控
  • whois - 域名信息查询
  • autorecon - 自动侦察
  • lazyrecon - 懒人侦察
  • sn1per - 渗透测试框架

🌐 Web爬虫 (Web Crawlers)

  • scrapy - Python爬虫框架
  • gospider - Go语言爬虫
  • linkfinder - JavaScript端点发现
  • js_scan - JavaScript扫描
  • secretfinder - 密钥发现
  • hakrawler - 快速爬虫
  • crawley - Web爬虫
  • photon - 极速爬虫
  • cewl - 自定义词表生成

🛡️ 漏洞扫描 (Vulnerability Scanners)

  • openvas - 开源漏洞评估
  • nmap_nse - Nmap脚本引擎
  • vulners - 漏洞数据库
  • vulmap - 漏洞映射

🔒 安全评估 (Security Assessment)

  • lynis - 安全审计工具
  • chkrootkit - Rootkit检测
  • rkhunter - Rootkit猎人
  • clamav - 反病毒扫描

🔑 密码攻击 (Password Attackers)

  • hydra - 在线密码破解
  • john - 离线密码破解
  • hashcat - 高级密码恢复
  • medusa - 并行登录暴力破解
  • patator - 多协议暴力破解
  • crowbar - 暴力破解工具
  • crunch - 密码生成器
  • johnny - John the Ripper GUI
  • hash_identifier - 哈希类型识别
  • wordlists - 词表管理工具

📡 无线工具 (Wireless Tools)

  • aircrack - WEP/WPA破解套件
  • reaver - WPS攻击工具
  • wifite - 自动化无线攻击
  • wifiphisher - 无线钓鱼攻击

🎭 社会工程 (Social Engineering)

  • beef - 浏览器利用框架
  • empire - 后渗透框架
  • set - 社会工程工具包
  • gophish - 开源钓鱼框架

💻 后渗透 (Post Exploitation)

  • mimikatz - Windows凭证提取
  • powersploit - PowerShell攻击框架
  • psexec - 远程执行工具
  • winexe - Windows远程执行

🔧 逆向工程 (Reverse Engineering)

  • ghidra - 软件逆向工程
  • ollydbg - Windows调试器
  • gdb - GNU调试器

💥 漏洞利用框架 (Exploit Frameworks)

  • metasploit - 渗透测试框架
  • exploitdb - 漏洞利用数据库

📱 移动安全 (Mobile Security)

  • mobsf - 移动安全框架
  • apktool - Android应用工具

☁️ 云安全 (Cloud Security)

  • pacu - AWS渗透测试
  • scout_suite - 云环境安全审计
  • cloudsploit - 云安全配置扫描

🔌 IoT安全 (IoT Security)

  • firmwalker - 固件分析工具
  • iotseeker - IoT设备扫描

📊 报告工具 (Reporting Tools)

  • dradis - 协作报告框架
  • serpico - 渗透测试报告
  • faraday - 协作渗透测试
  • magictree - 渗透测试数据管理
  • pipal - 密码分析工具
  • consolidated_report - 综合报告工具

📊 统计信息

  • 总工具数量: 91个工具
  • 分类数量: 16个类别

所有工具都已集成到MCP服务器中，可以通过相应的API端点进行调用。

配置说明

Kali服务器配置

在kali_server.py中可配置：

  • API_PORT - API服务端口（默认：5000）
  • DEBUG_MODE - 调试模式开关
  • COMMAND_TIMEOUT - 命令执行超时时间（秒）

MCP服务器配置

在mcp_server.py中可配置：

  • DEFAULT_KALI_SERVER - 默认Kali服务器地址
  • DEFAULT_REQUEST_TIMEOUT - API请求超时时间

安全注意事项

⚠️ 重要安全警告

  1. 授权测试：仅在获得明确授权的情况下使用本工具
  2. 法律合规：确保所有测试活动符合当地法律法规
  3. 网络隔离：建议在隔离的测试环境中使用
  4. 日志记录：所有操作都会被记录，确保可追溯性
  5. 数据保护：妥善处理测试过程中获取的敏感信息

故障排除

常见问题

  1. 连接失败

    • 检查Kali服务器是否正常运行
    • 验证网络连接和防火墙设置
    • 确认API端口未被占用

  2. 工具未找到

    • 确保Kali Linux已安装所需工具
    • 检查工具路径配置
    • 验证工具执行权限

  3. 权限错误

    • 确保以适当权限运行脚本
    • 检查文件系统权限
    • 验证网络访问权限

日志查看

所有操作日志可在控制台查看，或通过配置日志文件进行记录。

扩展开发

添加新工具

  1. 在kali_server.py中添加新的API端点
  2. 在mcp_server.py中注册对应的MCP工具函数
  3. 更新配置文件

自定义配置

支持通过环境变量和配置文件进行自定义配置。

许可证

本项目基于开源许可证发布，具体许可证信息请查看LICENSE文件。

贡献指南

欢迎提交Issue和Pull Request来改进本项目。

免责声明：本工具仅供安全研究和授权测试使用，使用者需对自身行为承担全部法律责任。