AI导哈

Kali工具MCP服务器

一个提供全面访问Kali Linux工具文档的模型上下文协议（MCP）服务器，通过Claude Desktop轻松搜索、探索和检索600多种渗透测试和安全工具的详细信息。

  • by Timohone
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Timohone/kali-mcp

使用说明

Kali Tools MCP 服务器

一个模型上下文协议（MCP）服务器，通过Claude Desktop提供对Kali Linux工具文档的全面访问。您可以轻松搜索、浏览并检索Kali Linux中包含的600多种渗透测试和安全工具的详细信息。

什么是Kali Linux？

Kali Linux是全球领先的渗透测试平台，提供了数百种用于安全测试、数字取证和逆向工程的工具。这款MCP服务器将完整的Kali工具集文档直接集成到您的Claude桌面环境中。

✨ 特点

  • 🔍 看起来像是一个放大镜的符号，通常用来表示“查看”、“搜索”或“调查”的意思。在中文里，可以简单翻译为“🔍 查看”、“🔍 搜索”或“🔍 调查”，具体取决于上下文。如果只是作为一个符号使用，也可以直接保留为“🔍”，不进行翻译。 智能搜索： 在600多个Kali工具中按名称、功能或类别查找工具
  • 📋（清单/条目） 类别组织： 按安全领域浏览工具（Web应用、取证、无线等）
  • 📖 书籍 详细文档： 访问安装说明、使用示例和命令语法
  • 🎯（瞄准靶心） 使用示例： 带有解释的真实命令行示例
  • 🐳 表示海豚或鲸鱼（根据具体语境可能有所不同），在中文里没有直接对应的单一文字描述，但通常可以用“海豚”或“鲸鱼”来表达其含义。不过，在网络用语或表情符号中，🐳 有时也被用作一种可爱的或幽默的表情，具体含义可能因语境而异。 容器化（Docker化）： 从官方仓库获取最新数据，实现简单部署
  • 🍎 苹果 针对Apple Silicon优化： M1/M2/M3 Macs 的原生 ARM64 支持
  • 🚀 表示火箭或快速上升/前进的符号，可翻译为“🚀”（火箭符号）或根据语境意译为“火箭”、“飞速前进”等。 按需： 每次会话都加载最新数据

用例

  • 渗透测试： 安全评估期间的工具快速参考指南
  • 安全研究： 为特定测试场景找到合适的工具
  • 认证准备（OSCP/CEH）： 了解道德黑客认证中使用的工具
  • 红队行动： 为各种攻击向量寻找专门工具
  • 蓝队防御： 了解攻击者工具以加强防御
  • 教育： 网络安全学生的综合学习资源
  • CTF竞赛： 快速查找可用工具及其功能

工具类别

  • 信息收集：DNS枚举、端口扫描、侦察
  • 漏洞分析：漏洞扫描器，漏洞利用数据库
  • Web应用程序：SQL注入测试、跨站脚本（XSS）测试、网络爬虫
  • 数据库评估：针对数据库的安全工具
  • 密码攻击：哈希破解、暴力破解、字典生成
  • 无线攻击：WiFi安全测试，蓝牙分析
  • 逆向工程：二进制分析、调试、反汇编
  • 利用工具：漏洞利用框架，有效载荷生成器
  • 法医学（此处更准确的翻译应为“法证科学”）：数字取证、数据恢复、内存分析
  • 嗅探与欺骗：网络监控、数据包捕获、中间人攻击（MITM）
  • 利用后阶段：权限提升、持久驻留、横向移动
  • 报告工具：文档编制和报告生成

快速入门

先决条件

  • Docker已安装并正在运行
  • Claude 桌面应用程序
  • 搭载Apple Silicon芯片的Mac（M1/M2/M3）或兼容系统

1. 创建项目

# Create project directory
mkdir kali-tools-mcp-server
cd kali-tools-mcp-server

# Copy the following files to this directory:
# - Dockerfile
# - requirements.txt
# - server.py

2. 构建Docker镜像

# Build the image for Apple Silicon (includes web scraping, takes 3-5 minutes)
docker build --platform linux/arm64 -t kali-tools-mcp-server .

3. 测试构建

docker run --rm --platform linux/arm64 kali-tools-mcp-server python -c "
import sys; sys.path.append('/app')
from server import KaliToolsServer
server = KaliToolsServer()
print(f'✅ Successfully loaded {len(server.tools_data)} Kali tools')
print(f'Categories: {list(server.categories.keys())}')
"

4. 配置Claude桌面版

编辑您的Claude桌面配置文件：

地点： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kali-tools": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--platform",
        "linux/arm64",
        "kali-tools-mcp-server",
        "python",
        "/app/server.py"
      ],
      "env": {}
    }
  }
}

5. 重启Claude桌面版

完全退出并重新启动Claude Desktop以加载新的MCP服务器。

使用示例

配置完成后，可直接通过Claude Desktop与Kali Tools数据库进行交互：

  • 搜索工具： “有哪些可用于SQL注入测试的Kali工具？”
  • 获取工具详情： “获取关于sqlmap的详细信息”
  • 按类别浏览： “列出所有Web应用程序测试工具”
  • 用法和示例： “给我展示sqlmap的使用示例”

MCP服务器工具

MCP服务器提供五种主要工具：

  1. search_kali_tools — 通过名称、描述或功能搜索Kali工具数据库
  2. get_tool_details — 获取特定工具的全面信息
  3. list_tools_by_category — 列出特定安全类别中的所有工具
  4. get_tool_usage — 获取特定工具的使用示例和命令语法
  5. list_categories — 显示所有可用的工具类别及工具数量

项目结构

kali-tools-mcp-server/
├── Dockerfile              # Container with Kali tools GitLab repository
├── requirements.txt        # Python dependencies (MCP, PyYAML)
├── server.py               # Main MCP server with PackagesInfo parsing
├── build.sh                # Automated setup script
└── README.md               # This documentation

建筑学（或简称为“建筑”）

  • 仓库克隆： 在构建过程中，从GitLab克隆官方Kali工具文档
  • PackagesInfo 解析： 从Markdown文件的PackagesInfo部分提取工具描述
  • 智能分类： 通过关键词分析自动按功能对工具进行分类
  • 内容提取： 解析YAML前置信息、使用示例和安装说明
  • MCP 接口： 通过MCP工具提供搜索和查询功能
  • 按需执行： 为每个 Claude Desktop 会话运行新的容器

数据来源

  • 来自GitLab仓库的Kali Linux官方工具文档
  • 包含index.md文件的单个工具目录
  • PackagesInfo 部分，YAML 前置元数据，使用示例
  • 基于工具描述和功能的智能分类

关键解析特性

  • 软件包信息检测： 自动查找并提取“PackagesInfo:”部分之后的内容
  • YAML 前置元数据（Frontmatter）： 提取标题、主页、仓库和其他元数据
  • 内容清理： 过滤掉 Hugo 短代码和 HTML 注释

故障排除

  • 构建过程比预期时间更长： 构建过程包括克隆完整的Kali工具GitLab仓库
  • 加载的工具有限： 检查GitLab仓库是否已成功克隆
  • 描述解析问题： 大多数工具应从PackagesInfo部分中拥有有意义的描述

许可与署名

此项目旨在用于教育及合法的安全研究目的。

  • Kali 工具数据：受 Kali Linux 文档许可协议约束
  • GitLab 仓库地址：https://gitlab.com/kalilinux/documentation/kali-tools
  • MCP服务器代码：用于教育用途，需遵循负责任的安全实践
  • Docker 配置：可自由用于合法的安全研究

如需设置说明，请参阅 setup.md。

相关 MCP