🐳 Docker Explorer MCP-сервер

📋 Обзор

Docker Explorer — это мощный сервер Model Context Protocol (MCP), который предоставляет инструменты и ресурсы для взаимодействия с образами, контейнерами и реестрами Docker. Этот сервер позволяет помощникам ИИ, таким как Клод, искать, анализировать и взаимодействовать с ресурсами Docker через стандартизированный интерфейс, делая управление контейнерами и их исследование более доступными.

✨ Особенности

Основные характеристики

• Поиск образов Docker в реестрах

• Поиск определенных тегов образов Docker

• Поиск пользователей/организаций Docker Hub

• Получите подробные метаданные об образах Docker

• Анализ содержимого Dockerfile

• Сравнение образов Docker

Расширенные инструменты

• 🔒 Сканер безопасности : анализ образов Docker на наличие известных уязвимостей и проблем безопасности

• 📦 Оптимизатор размера образа : получите рекомендации по уменьшению размера образа Docker

• 📄 Docker Compose Generator : сгенерируйте файлы docker-compose.yml для ваших приложений

• 📊 Анализатор времени выполнения контейнера : получите представление о поведении времени выполнения контейнера и использовании ресурсов.

• 🔍 Инструмент сравнения образов : сравните два образа Docker и выделите их различия

• 📜 Генератор Dockerfile : создание Dockerfile из описаний приложений на естественном языке

🚀 Установка

Предпосылки

• Python 3.10 или выше

• MCP Python SDK

• Требуемые пакеты Python: requests , pydantic

Настраивать

1. Клонируйте этот репозиторий :

2. Создайте виртуальную среду :

3. Установить зависимости :

Или установите отдельные пакеты:

💻 Использование

Запуск сервера

Вы можете запустить сервер прямо из командной строки:

Это запустит сервер MCP на порту по умолчанию (5000).

Интеграция с Claude Desktop

Чтобы использовать сервер Docker Explorer MCP с Claude Desktop:

1. Обновите конфигурацию Claude Desktop :

   • Откройте или создайте файл claude_desktop_config.json в каталоге конфигурации Claude Desktop.

   • Добавьте конфигурацию сервера Docker Explorer

2. Перезапустите Claude Desktop , чтобы загрузить новую конфигурацию.

Использование инструментов

После интеграции с Claude Desktop вы сможете использовать инструменты Docker Explorer, задавая Клоду такие вопросы:

Основные инструменты

1. Поиск образов Docker :

   Can you search for Python Docker images?

2. Получить сведения об изображении :

   What are the details of the python:3.11-slim image?

3. Найти доступные теги :

   What tags are available for the nginx image?

Расширенные инструменты

4. Сканер безопасности :

   Scan the security of the nginx image

5. Оптимизатор размера изображения :

   How can I reduce the size of my python:3.9 image?

6. Генератор Docker Compose :

   Generate a docker-compose file for nginx with port 8080:80

7. Анализатор времени выполнения контейнера :

   Analyze the runtime behavior of mysql:5.7 as a database

👷 Развитие

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

Добавление новых функций

Чтобы добавить новый инструмент на сервер Docker Explorer MCP:

1. Реализуйте функцию инструмента в docker_explorer.py с помощью декоратора инструмента MCP:

2. Следуйте этим рекомендациям по внедрению инструмента:

   • Сохраняйте выходные данные краткими и отформатированными для Claude Desktop

   • Обрабатывайте исключения изящно

   • Предоставьте четкие описания параметров

   • Возвращайте хорошо структурированные результаты

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

1. Ручное тестирован��е :

   • Запускаем сервер: python docker_explorer.py

   • Тестируйте с помощью Claude Desktop, задавая соответствующие вопросы

2. Отладка :

   • Проверьте вывод терминала на наличие ошибок.

   • Проверка ответов инструмента в Claude Desktop

   • Отрегулируйте форматирование вывода, если у Клода есть ограничения по емкости

📚 API-документация

Основные инструменты

search_images

• Описание : Поиск образов Docker в реестрах.

• Параметры :

  • query (строка): Поисковый запрос для образов Docker

  • limit (целое число, по умолчанию = 10): максимальное количество возвращаемых результатов

• Возвращает : список образов Docker с метаданными.

search_tags

• Описание : Поиск определенных тегов образа Docker.

• Параметры :

  • image_name (string): Имя образа Docker

  • tag_pattern (string, default=""): Шаблон для сопоставления тегов

  • limit (целое число, по умолчанию = 25): максимальное количество возвращаемых результатов

• Возвращает : Список соответствующих тегов

get_image_details

• Описание : Получите подробную информацию об образе Docker.

• Параметры :

  • image_name (string): Имя образа Docker

  • tag (string, default="latest"): тег образа Docker

• Возврат : Подробная информация об изображении

Расширенные инструменты

scan_security

• Описание : Анализ образов Docker на предмет известных уязвимостей и проблем безопасности.

• Параметры :

  • image_name (string): Имя образа Docker

  • tag (string, default="latest"): тег образа Docker для сканирования

• Возвращает : отчет по анализу безопасности с рекомендациями

optimize_image_size

• Описание : Анализ образа Docker и предложение способов уменьшения его размера.

• Параметры :

  • repository_url (строка): Полный URL-адрес репозитория Docker Hub

  • tag (string, default="latest"): тег образа Docker для анализа

• Возврат : Рекомендации по оптимизации размера

generate_docker_compose

• Описание : Создание файла docker-compose.yml на основе образа.

• Параметры :

  • repository_url (строка): Полный URL-адрес репозитория Docker Hub

  • tag (string, default="latest"): тег образа Docker

  • port_mapping (string, default=""): Необязательное сопоставление портов (например, '8080:80')

  • environment_variables (string, default=""): Необязательные переменные среды

  • include_db (boolean, default=false): следует ли включать службу базы данных

• Возвращает : сгенерированное содержимое docker-compose.yml

analyze_runtime

• Описание : Анализ того, как контейнер может вести себя во время выполнения.

• Параметры :

  • image_name (string): Имя образа Docker

  • tag (string, default="latest"): тег образа Docker

  • app_type (string, default="web"): Тип приложения (веб, база данных, кэш, API, пакетное)

• Возвращает : анализ времени выполнения с прогнозами и рекомендациями по использованию ресурсов.

compare_images

• Описание : Сравните два образа Docker и выделите различия.

• Параметры :

  • image1 (строка): первый образ Docker для сравнения (например, «nginx:1.21» или «user/repo:tag»)

  • image2 (строка): второй образ Docker для сравнения (например, «nginx:1.22» или «user/repo:tag»)

• Возврат : Подробный сравнительный отчет, в котором указаны различия в размерах, слоях, конфигурации и совместимости.

generate_dockerfile

• Описание : Создание Dockerfile на основе требований приложения, описанных на естественном языке.

• Параметры :

  • app_description (string): Описание приложения для контейнеризации (например, «веб-приложение Python Flask с Redis»)

  • app_type (string, default="web"): Тип приложения (веб, API, база данных, рабочий, статический)

  • base_image (string, default=""): необязательное базовое изображение для использования (например, 'python:3.9-alpine')

  • include_comments (boolean, default=true): включать ли пояснительные комментарии в Dockerfile

• Возвращает : сгенерированный Dockerfile с инструкциями по использованию.

🔒 Вопросы безопасности

Сервер Docker Explorer MCP предназначен для образовательных и развивающих целей. При его использовании:

• Не раскрывайте конфиденциальные учетные данные или ключи API.

• Будьте осторожны при создании и запуске файлов Docker Compose.

• Всегда проверяйте рекомендации по безопасности перед их реализацией.

📌 Лицензия

Массачусетский технологический институт

👥 Вклад

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