Claude Kali MCP Commander

Интеграция MCP Клода Кали

Чистая, минимальная реализация интеграции Kali Linux MCP (Model Context Protocol) для Claude Desktop, обеспечивающая безопасный доступ к инструментам Kali Linux через интерфейс Claude. Этот проект обеспечивает бесперебойное выполнение инструментов и команд безопасности в изолированном контейнере Docker.

Функции

• 🐳 На основе Docker — Контейнерная среда для последовательного выполнения
• 🔒 Изолированная среда — инструменты Kali Linux в безопасной песочнице
• 🔄 Автоматические проверки работоспособности — обеспечивают надежность и доступность услуг
• 📡 MCP Server — стандартная интеграция протокола с Claude Desktop
• 🚀 Быстрая настройка — начните работу с минимальной конфигурацией
• 🔧 Настраиваемый — настраиваемые порты и параметры
• 🔍 Security-First — изолированная среда выполнения для инструментов безопасности
• 📊 Мониторинг — встроенные проверки работоспособности и конечные точки статуса

Предпосылки

• Докер (v20.10.0+)
• Docker Compose (v2.0.0+)
• Git (для клонирования репозитория)
• Node.js (v16+ для разработки и тестирования)

Сетевая заметка

По умолчанию предоставленные файлы docker-compose.yml и docker-compose.full.yml используют хостовую сеть ( network_mode: host ). Это дает контейнерам полный доступ к хостовой сети, что требуется для некоторых расширенных сетевых инструментов и сценариев.

Примечание по безопасности:

• Сетевое подключение хоста обеспечивает меньшую изоляцию между вашим хостом и контейнерами. Все сетевые интерфейсы и порты являются общими.
• Если вы предпочитаете большую изоляцию, вы можете переключиться на bridge сеть Docker по умолчанию, удалив строки network_mode: host и добавив сопоставление ports: (например, 8081:8080 ) к соответствующим службам. Подробности см. в прокомментированных примерах в файлах компоновки и документации ниже.

Быстрый старт

1. Клонируйте репозиторий :
   git clone https://github.com/house-of-stark/Claude-Kali-MCP-Commander cd Claude-Kali-MCP-Commander

🛠️ Инструкции по сборке и запуску

Примечание: sudo включено внутри контейнера Kali для таких инструментов, как nmap и других, требующих повышенных привилегий. Если вы хотите ограничить использование sudo , отредактируйте список blockedCommands в config.json .

Windows (PowerShell)

Примечание: Если вы видите ошибку подписи скрипта или политики выполнения, запустите скрипт с обходом ExecutionPolicy:

1. Минимальная сборка (рекомендуется):
   powershell -ExecutionPolicy Bypass -File .\build.ps1 docker-compose up -d
2. Полная сборка инструментов Kali:
   powershell -ExecutionPolicy Bypass -File .\build.ps1 -Profile full docker-compose -f docker-compose.full.yml up -d

Linux/macOS (Bash)

1. Минимальная сборка (рекомендуется):
   ./build.sh minimal docker-compose up -d
2. Полная сборка инструментов Kali:
   ./build.sh full docker-compose -f docker-compose.full.yml up -d

Запуск и мониторинг служб

• Скрипт быстрого старта (Linux/macOS):
  chmod +x start.sh ./start.sh
  Это создает и запускает контейнеры, ждет готовности и показывает статус.
• Проверьте конечную точку работоспособности:
  curl http://localhost:8080/health
  Должен вернуть: {"status":"ok"}
• Просмотр запущенных контейнеров:
  docker ps --filter "name=kali-mcp-commander"

Настроить рабочий стол Клода

• Установите URL-адрес сервера MCP на: http://localhost:8080
• (Необязательно) Укажите путь к проекту в вашем локальном каталоге репозитория.

2. Выберите свой профиль сборки :
   • Минимальный (по умолчанию) : небольшое изображение только с сервером MCP (рекомендуется для большинства пользователей)
     ./build.sh minimal docker-compose up -d
   • Полная версия : полная версия Kali Linux со всеми инструментами (очень большое изображение)
     ./build.sh full docker-compose -f docker-compose.full.yml up -d

   Минимальная сборка намного быстрее и меньше, в то время как полная сборка включает в себя все инструменты Kali Linux, но требует значительного дискового пространства.

3. Проверьте установку :
   curl http://localhost:8081/health
   Должен вернуть: {"status":"ok"}
4. Настройте рабочий стол Claude :
   • Откройте настройки Claude Desktop
   • Установите URL-адрес сервера MCP на: http://localhost:8081
   • Установите Project Path на полный путь к этому репозиторию (например, /path/to/Claude-Kali-MCP-Commander )
   • Перезагрузить рабочий стол Клода

Структура проекта

Тестирование интеграции

После запуска служб вы можете протестировать интеграцию MCP:

1. Базовая проверка работоспособности : (при использовании моста к Docker)
   curl http://localhost:8081/health
   Должен вернуть: {"status":"ok"}
2. Проверить статус контейнера :
   docker ps --filter "name=kali-mcp-commander-minimal"
   Контейнер должен отображаться как «здоровый».
3. Просмотр журналов контейнеров :
   docker logs kali-mcp-commander
   Проверьте наличие сообщений об ошибках или предупреждений.

Конфигурация

Конфигурация рабочего стола Клода

Чтобы использовать этот MCP-сервер с Claude Desktop, вам необходимо настроить следующее в настройках Claude Desktop:

1. Kali Linux MCP (обязательно) : запускает команды внутри контейнера Docker с помощью инструментов Kali Linux.
2. Host OS Commander (опционально) : может использоваться для запуска команд непосредственно на хостовой ОС, где установлен Claude Desktop. Вы можете удалить этот раздел, если вам нужна только среда Kali Linux.

Пример одного сервера MCP claude_desktop_config.json :

Пример ОС MCP Commander для настольного компьютера и сервера Kali MCP claude_desktop_config.json :

Переменные среды

В файле docker-compose.yml можно настроить следующие переменные среды:

• MCP_SERVER_PORT : Порт для сервера MCP (по умолчанию: 8080)
• NODE_ENV : Режим среды (разработка/производство)
• LOG_LEVEL : Уровень детализации журнала (отладка, информация, предупреждение, ошибка)

Конфигурация порта (если не используется хост-сеть)

Чтобы изменить порты по умолчанию, измените раздел ports в docker-compose.yml :

Поиск неисправностей

Распространенные проблемы

1. Конфликты портов
   • Симптом : Контейнер не запускается из-за ошибок привязки портов.
   • Решение : Измените порт хоста в docker-compose.yml
2. Проверка работоспособности контейнера не пройдена
   • Симптом : Контейнер постоянно перезапускается.
   • Решение : Проверьте логи с помощью docker logs kali-mcp-commander-minimal
3. Сервер MCP не отвечает
   • Симптом : Claude Desktop не может подключиться к серверу MCP
   • Решение :
     • Проверьте, работает ли сервер: curl http://localhost:8081/health
     • Проверьте настройки сети Docker
     • Убедитесь, что брандмауэр не блокирует порт 8081.

Отладка

Для детальной отладки вы можете изменить docker-compose.yml , включив дополнительное логирование:

Соображения безопасности

• Контейнер работает с минимальными привилегиями.
• Сетевой доступ по умолчанию ограничен локальным хостом.
• Для базового образа Kali Linux рекомендуется регулярно обновлять систему безопасности.
• Проверьте Dockerfile на наличие пользовательских конфигураций.

Производительность

• Контейнер оптимизирован для минимального использования ресурсов.
• Проверки работоспособности гарантируют доступность услуг
• Ограничения ресурсов можно настроить в docker-compose.yml

Внося вклад

Вклады приветствуются! Пожалуйста, ознакомьтесь с нашими Правилами по вкладам для получения подробной информации о том, как внести вклад в этот проект.

При внесении пожертвования, пожалуйста:

1. Форк репозитория
2. Создать ветку функций
3. Зафиксируйте ваши изменения
4. Нажмите на ветку
5. Создать новый запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Авторские права (c) 2025 Крис Старк. Поддерживается Крисом Старком.

Кредиты

• Оригинальная работа Эдуарда Рузги (2024)

Поддерживать

Для получения поддержки, пожалуйста, создайте запрос на GitHub.