使用说明

项目简介

本项目是一个MCP服务器,旨在集成Kali Linux安全工具,使LLM能够利用这些工具执行网络分析、二进制逆向工程等任务。它使用FastMCP框架将Kali工具作为可在MCP环境中调用的功能公开。

主要功能点

  • 网络扫描: 使用Nmap进行各种类型的扫描(基本扫描、 интенсив扫描、隐秘扫描、快速扫描、漏洞扫描)。
  • 二进制分析: 使用nm和objdump进行符号分析、反汇编和头部检查。
  • 字符串提取: 利用strings从二进制文件中提取文本。
  • 网络流量分析: 集成Wireshark/tshark用于捕获和分析网络流量。
  • 沙箱执行: 提供基于Docker的沙箱,用于安全地执行命令。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/ccq1/awsome_kali_MCPServers.git
  2. 进入目录:
    cd awsome_kali_MCPServers
  3. 安装依赖: 虽然 'setup.py' 文件为空,但根据 'mcp_server.py' 的代码,项目可能依赖 'fastmcp' 和 'docker' Python库。请确保安装这些依赖。
    pip install fastmcp docker
  4. 安装Docker:
    确保您的系统上已安装并运行 Docker,因为沙箱功能依赖于 Docker。

服务器配置

要从MCP客户端连接到此MCP服务器,您需要在客户端中配置以下服务器详细信息。服务器通过 'stdio' 传输方式启动。

{
  "serverName": "kali-tools",
  "command": "python",
  "args": ["app.py"]
}
  • 'serverName': 服务器的描述性名称,这里是 "kali-tools"。
  • 'command': 启动服务器要执行的命令,这里是 'python'。
  • 'args': 命令的参数列表,这里是 '["app.py"]',用于执行服务器脚本。

基本使用方法

  1. 启动服务器:
    使用配置文件中指定的命令(例如,在仓库根目录下运行 'python app.py')启动服务器。服务器将启动并通过stdio进行通信。启动后,您将在控制台中看到 "Starting server is running" 的消息。
  2. 配置MCP客户端:
    配置您的MCP客户端以使用上面提供的JSON配置连接到此服务器。
  3. 使用工具:
    连接成功后,您可以使用定义的工具(例如,'basic_scan'、'disassemble'、'capture_live')。有关工具参数和描述,请参阅 'src/mcp_server.py' 中的函数文档字符串。例如,要执行基本的nmap扫描,您可能会调用 'basic_scan' 工具,并将目标IP地址作为参数。

信息

分类

开发者工具