Skip to main content
Glama
thargy
by thargy

Docker MCP Server (docker-mcp)

Node.js Version License: MIT Architecture: Deep Module TypeScript

Model Context Protocol (MCP) сервер, предоставляющий высокоэфектعة инструменты для интспекции, оркестrats и устранения проблем в срдах Docker Engine и Docker Compose.

Построен на @thargy/mcp-server-core в соответствии с философией Deep Module Джона Аустерхаута (A Philosophy of Software Design).


1. Архитектурное видение: Deep Module против раздувания инструментов

Традиционные MCP-серверы сопоставляются 1:1 с командами Docker CLI, что приводит к появлению 30+ неглубоких инструментов, которые раздувают контекстное окно LLM (потребляя более 4,000 контекстных токенов за оборот) и усиливают галлюцинации.

docker-mcp предоставляет ровно 6 консолидированных, высокоэффективных инструментов с полиморфными типизированными дискриминаторами действий и потребляет <1,000 токенов:

graph LR
    subgraph Clients ["MCP Clients"]
        Claude["Claude Desktop (Stdio)"]
        Agent["Antigravity / Coding Agents"]
        Gateway["mcp-gateway (SSE / Streamable HTTP)"]
    end

    subgraph DeepModule ["docker-mcp (Deep Module)"]
        T1["docker_containers"]
        T2["docker_compose"]
        T3["docker_images"]
        T4["docker_volumes"]
        T5["docker_networks"]
        T6["docker_system"]
        
        Seam["IDockerClient Seam"]
        Engine["DockerodeClient / InMemoryDockerClient"]
    end

    subgraph Host ["Docker Infrastructure"]
        Socket["/var/run/docker.sock"]
        RemoteTCP["tcp://remote-host:2376"]
        RemoteSSH["ssh://user@remote-host"]
    end

    Clients --> DeepModule
    DeepModule --> Seam
    Seam --> Engine
    Engine --> Host

2. Консолидированный каталог MCP-инструментов

Инструмент

Действия

Возможно и особенности

docker_containers

list, inspect, start, stop, restart, logs, stats, exec, remove

Фильтрация по имени/статусу через наличие чувствительных выражений, расчёт CPU/RAM в реальном времени, извлечение мультиплексированных журналов stdout/stderr, выполнение команд, безопасные тайм-ауты.

docker_compose

ps, up, down, restart, logs

Множество артефактов через labels или директории, оркестровка жизненного цикла, проверка готовности с помощью healthcheck.

docker_images

list, inspect, pull, prune, remove

Каталог образов, формирование виртуальных размеров, разрешение тегов, очистка висячих (незаданных) образов.

docker_volumes

list, inspect, create, prune, remove

Каталог настойчивых томов, просмотр драйверов, очистка изолированных томов.

docker_networks

list, inspect, create, prune, remove

Инструменты для просмотра топологии bridge, overlay и macvlan, разбор подсетей.

docker_system

info, df, prune, version, ping

Мониторинг демона, версия Docker Engine, детализация использования дисков, глобальная очистка.


3. Быстрый старт и конфигурация

Переменные окружения

Переменная

По умолчанию

Описание

PORT

3008

Порт для прослушивания HTTP / SSE

HOST

0.0.0.0

Адрес привязки

MCP_TOKEN

необязательно

Секретный токен для Bearer-аутентификации через HTTP / SSE

DOCKER_SOCKET

/var/run/docker.sock

Путь к локальному Unix-сокету Docker

DOCKER_HOST

необязательно

Remote Docker TCP URL (например, tcp://192.168.86.50:2376)

DOCKER_TLS_VERIFY

необязательно

Включить проверку TLS-сертификатов (1 or 0)

DOCKER_CERT_PATH

необязательно

Путь к клиентским TLS-сертификатам (ca.pem, cert.pem, key.pem)

Запуск через Stdio (Claude Desktop / локальный CLI)

{
  "mcpServers": {
    "docker": {
      "command": "node",
      "args": ["/Users/craigdean/Repos/docker-mcp/dist/src/index.js"],
      "env": {
        "DOCKER_SOCKET": "/var/run/docker.sock"
      }
    }
  }
}

Запуск через Docker Compose и mcp-gateway

docker compose up -d --build

Доступ к HTTP SSE: http://localhost:3008/docker/mcp или http://localhost:3008/docker/sse


4. Тестирование и качество кода

100% модульных тестов исполняются с использованием InMemoryDockerClient, без необходимости виртуального Docker-сокета.

# Run unit tests
npm test

# Run test coverage (>85% required)
npm run test:coverage

# TypeScript compile check
npm run types:check

Лицензия

MIT © 2026 Craig Dean

-
license - not tested
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Free MCP tools: the only MCP linter, health checks, cost estimation, and trust evaluation.

  • Official Sevalla MCP — full PaaS API access through just 2 tools.

  • 34 production API tools over one hosted MCP endpoint.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/thargy/docker-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server