🐳 Docker Mcp

Создано

QuantGeekDev•Aug 22, 2025

Сервер Docker MCP (протокол контекста модели)

Обзор

Что такое Docker MCP?

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

Особенности Docker MCP

Управление контейнерами: Docker MCP упрощает управление контейнерами, позволяя пользователям легко развертывать, обновлять и масштабировать приложения.
Стандартизированный протокол: Он использует стандартизированный протокол для контекстов моделей, обеспечивая совместимость и легкость интеграции с различными инструментами и сервисами.
Масштабируемость: Архитектура Docker MCP позволяет бесшовное масштабирование приложений, что позволяет справляться с увеличенными нагрузками без ущерба для производительности.
Удобный интерфейс: Docker MCP предлагает интуитивно понятный интерфейс, который облегчает разработчикам взаимодействие с их контейнеризованными приложениями.
Открытый исходный код: Будучи проектом с открытым исходным кодом, Docker MCP поощряет вклад сообщества и сотрудничество, способствуя инновациям и постоянному улучшению.

Как использовать Docker MCP

Установка: Начните с установки Docker на вашем компьютере. Следуйте официальной документации Docker для инструкций по установке.
Клонирование репозитория: Используйте Git для клонирования репозитория Docker MCP с GitHub:
```
git clone https://github.com/QuantGeekDev/docker-mcp.git
```
Конфигурация: Перейдите в клонированный каталог и настройте необходимые параметры в конфигурационных файлах в соответствии с требованиями вашего проекта.
Запуск сервера: Запустите сервер Docker MCP с помощью команд Docker. Убедитесь, что все зависимости выполнены и среда правильно настроена.
Развертывание приложений: Используйте интерфейс Docker MCP для развертывания ваших приложений, управления контейнерами и мониторинга производительности.
Масштабирование: По мере роста вашего приложения используйте функции масштабирования Docker MCP для обработки увеличенного трафика и требований к ресурсам.

Часто задаваемые вопросы

В1: Каковы системные требования для Docker MCP?

О1: Docker MCP требует машину с установленным Docker. Рекомендуется иметь как минимум 4 ГБ ОЗУ и многоядерный процессор для оптимальной производительности.

В2: Подходит ли Docker MCP для производственных сред?

О2: Да, Docker MCP разработан как надежный и масштабируемый, что делает его подходящим для производственных сред. Однако рекомендуется провести тщательное тестирование перед развертыванием.

В3: Могу ли я внести вклад в Docker MCP?

О3: Абсолютно! Docker MCP — это проект с открытым исходным кодом, и вклад приветствуется. Вы можете отправлять проблемы, запросы на функции или пулл-запросы в репозиторий на GitHub.

В4: Как Docker MCP сравнивается с другими инструментами оркестрации контейнеров?

О4: Docker MCP сосредоточен на управлении контекстом моделей и предоставляет удобный интерфейс, что облегчает разработчикам управление своими приложениями по сравнению с некоторыми более сложными инструментами оркестрации.

В5: Где я могу найти документацию для Docker MCP?

О5: Документация для Docker MCP доступна в файле README репозитория и в дополнительных ресурсах, связанных с репозиторием.

Деталь

🐳 docker-mcp

A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.

✨ Features

🚀 Container creation and instantiation
📦 Docker Compose stack deployment
🔍 Container logs retrieval
📊 Container listing and status monitoring

🎬 Demos

Deploying a Docker Compose Stack

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

Analyzing Container Logs

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

🚀 Quickstart

To try this in Claude Desktop app, add this to your claude config files:

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

Installing via Smithery

To install Docker MCP for Claude Desktop automatically via Smithery:

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

Prerequisites

UV (package manager)
Python 3.12+
Docker Desktop or Docker Engine
Claude Desktop

Installation

Claude Desktop Configuration

Add the server configuration to your Claude Desktop config file:

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

<details> <summary>💻 Development Configuration</summary>

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

</details> <details> <summary>🚀 Production Configuration</summary>

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

</details>

🛠️ Development

Local Setup

Clone the repository:

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

Create and activate a virtual environment:

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

Install dependencies:

uv sync

🔍 Debugging

Launch the MCP Inspector for debugging:

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

The Inspector will provide a URL to access the debugging interface.

📝 Available Tools

The server provides the following tools:

create-container

Creates a standalone Docker container

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

deploy-compose

Deploys a Docker Compose stack

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

get-logs

Retrieves logs from a specific container

{
    "container_name": "my-container"
}

list-containers

Lists all Docker containers

{}

🚧 Current Limitations

No built-in environment variable support for containers
No volume management
No network management
No container health checks
No container restart policies
No container resource limits

🤝 Contributing

Fork the repository from docker-mcp
Create your feature branch
Commit your changes
Push to the branch
Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

✨ Authors

Alex Andru - Initial work | Core contributor - @QuantGeekDev
Ali Sadykov - Initial work | Core contributor - @md-archive

Made with ❤️

Конфигурация сервера

{
  "mcpServers": {
    "docker-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/metorial/mcp-container--quantgeekdev--docker-mcp--docker-mcp",
        "docker-mcp"
      ],
      "env": {}
    }
  }
}

Информация о проекте

Автор

QuantGeekDev