🐳 docker-mcp

Мощный сервер Model Context Protocol (MCP) для операций с Docker, обеспечивающий бесшовное управление контейнерами и стеками Compose через Claude AI.

✨ Возможности

• 🚀 Создание и запуск контейнеров
• 📦 Развёртывание стеков Docker Compose
• 🔍 Получение журналов контейнеров
• 📊 Вывод списка контейнеров и мониторинг статуса

🎨 Демонстрации

Развёртывание стека Docker Compose

https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278

Анализ журналов контейнеров

https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934

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

Чтобы попробовать это в приложении Claude Desktop, добавьте следующее в файлы конфигурации Claude:

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uvx",
      "args": [
        "docker-mcp"
      ]
    }
  }
}

Установка через Smithery

Для автоматической установки Docker MCP для Claude Desktop через Smithery:

npx @smithery/cli install docker-mcp --client claude

Предварительные требования

• UV (менеджер пакетов)
• Python 3.12+
• Docker Desktop или Docker Engine
• Claude Desktop

Установка

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

Добавьте конфигурацию сервера в файл конфигурации Claude Desktop:

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

💻 Конфигурация для разработки

{
"mcpServers": {
  "docker-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "<path-to-docker-mcp>",
      "run",
      "docker-mcp"
    ]
  }
}
}

🚀 Конфигурация для продакшена

{
"mcpServers": {
  "docker-mcp": {
    "command": "uvx",
    "args": [
      "docker-mcp"
    ]
  }
}
}

🛠️ Разработка

Локальная настройка

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

git clone https://github.com/QuantGeekDev/docker-mcp.git
cd docker-mcp

1. Создайте и активируйте виртуальное окружение:

python -m venv venv
source venv/bin/activate  # На Windows: venv\Scripts\activate

1. Установите зависимости:

uv sync

🔍 Отладка

Запустите MCP Inspector для отладки:

npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp

Inspector предоставит URL-адрес для доступа к интерфейсу отладки.

📝 Доступные инструменты

Сервер предоставляет следующие инструменты:

create-container

Создаёт отдельный контейнер Docker

{
    "image": "image-name",
    "name": "container-name",
    "ports": {"80": "80"},
    "environment": {"ENV_VAR": "value"}
}

deploy-compose

Развёртывает стек Docker Compose

{
    "project_name": "example-stack",
    "compose_yaml": "version: '3.8'\nservices:\n  service1:\n    image: image1:latest\n    ports:\n      - '8080:80'"
}

get-logs

Получает журналы из указанного контейнера

{
    "container_name": "my-container"
}

list-containers

Выводит список всех контейнеров Docker

{}

🚧 Текущие ограничения

• Отсутствует встроенная поддержка переменных окружения для контейнеров
• Отсутствует управление томами
• Отсутствует управление сетями
• Отсутствуют проверки работоспособности контейнеров
• Отсутствуют политики перезапуска контейнеров
• Отсутствуют ограничения ресурсов контейнеров

🤝 Участие в разработке

1. Сделайте форк репозитория docker-mcp
2. Создайте ветку для вашей функции
3. Зафиксируйте изменения
4. Отправьте в ветку
5. Откройте запрос на слияние

📜 Лицензия

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

✨ Авторы

• Alex Andru - Начальная работа | Основной участник - @QuantGeekDev
• Ali Sadykov - Начальная работа | Основной участник - @md-archive

Сделано с ❤️