Docker MCP Server — MCP-сервер для Claude Code: управление Docker
Даёт агенту доступ к Docker: контейнеры, образы, сети, тома, Swarm. Пригодится, когда нужно разбираться с падениями и состоянием окружения прямо из чата.
claude mcp add docker-mcp-server -- uvx docker-mcp-serverЧто делает Docker MCP Server
Сервер публикует операции Docker отдельными типизированными инструментами. У каждого помечено, только ли он читает данные, а разрушительные действия вынесены в отдельную категорию. Клиент может сам подтверждать чтение и всегда спрашивать перед удалением. Весь сервер переключается в режим «только чтение» или «без разрушительных операций» — тогда инструменты с записью просто не регистрируются.
Вывод ограничен по размеру: вместо того чтобы молча забивать контекст агента, ответ обрезается и получает флаг truncated. Логи и статистика отдаются как ресурсы, поэтому можно спрашивать, почему контейнер упал или сколько места занимают тома. Для простого случая настройка не нужна: сервер сам находит локальный сокет Docker. Несколько демонов — локальный и удалённый по TCP, TLS или SSH — подключаются в одной сессии, а отдельные можно пометить как доступные только для чтения.
Работает нативно, как бандл .mcpb, как плагин Claude или в контейнере; телеметрию не отправляет. Нужен запущенный демон Docker, доступный с той машины, где крутится сервер, а также Python 3.14 и выше и uv. На Intel-маках при нативной установке через uvx, pip, плагин Claude или .mcpb дополнительно требуются Rust и OpenSSL 3.x: зависимость cryptography там собирается из исходников. Контейнерный образ эту возню снимает — в нём готовый бинарник под Linux.
Какие задачи решает
- разобраться, почему контейнер завершился с ошибкой
- посмотреть состояние сервисов Swarm
- проверить, сколько диска съели тома
- сравнить окружения теста и продакшена
- управлять удалённым демоном по SSH без доступа к шеллу
Примеры запросов агенту
- Почему упал контейнер
api? Покажи последние логи и статистику. - Сколько места занимают тома и какие из них можно удалить?
- Сравни список образов на локальном демоне и на удалённом по SSH.
Как установить Docker MCP Server
Командой платформы
claude mcp add docker-mcp-server -- uvx docker-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from docker-mcp-server <команда>
Командой платформы
codex mcp add docker-mcp-server -- uvx docker-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from docker-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"docker-mcp-server": {
"command": "uvx",
"args": [
"docker-mcp-server"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from docker-mcp-server <команда>
Файл настроек
{
"servers": {
"docker-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"docker-mcp-server"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from docker-mcp-server <команда>
Командой платформы
gemini mcp add docker-mcp-server uvx docker-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from docker-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Docker MCP Server
Как установить Docker MCP Server в Claude Code?
Одной командой: claude mcp add docker-mcp-server -- uvx docker-mcp-server. uv скачает и закеширует пакет при первом запуске.
Что делает Docker MCP Server?
Открывает агенту операции Docker через Docker SDK и CLI: контейнеры, образы, сети, тома, сервисы Swarm, секреты, конфиги, узлы. Логи и статистика доступны как ресурсы для мониторинга.
Что нужно для работы сервера?
Запущенный демон Docker, до которого дотягивается хост с сервером, Python 3.14 и выше и uv. На Intel-маках нативная установка дополнительно требует Rust и OpenSSL 3.x.
