Skip to main content
Glama
deenesjakoruzh
thargy

docker-mcp

by thargy
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

Related MCP server: Docker MCP Server

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

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Docker MCP

    Isak-Landin
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables remote Docker management over SSH via a local MCP server, providing tools to manage containers, images, Compose, and system resources.
    1
    GPL 3.0

  • Docker MCP Server

    0xshariq
    A
    license
    Not graded
    quality
    D
    maintenance
    A comprehensive MCP server that provides advanced Docker operations through a unified interface with 16 MCP tools and 25+ CLI aliases, enabling secure container lifecycle management, multi-container orchestration, registry publishing, and system maintenance.
    19 npm
    15
    ISC

  • docker-mcp

    mpgharris
    A
    license
    A
    quality
    C
    maintenance
    Wraps the Docker Engine API as MCP tools for container and image management. Reduces token consumption by providing typed tools with default summaries and field selection.
    17
    148 npm
    MIT