Сервер MCP (Model Context Protocol), который предоставляет Dockhand API в качестве инструментов MCP. Управляйте всей инфраструктурой Docker с помощью помощников.

** Покрытие API: ** 88,7% конечных точек Dockhand (282/318) имеют инструмент MCP — см. docs/coverage.md для полного автоматического обновления по площади.

Dockhand - это сервер управления Docker, который подключается к нескольким хостам Docker через агенты Hawser. Этот MCP-сервер обеспечивает полный программный доступ ко всем функциям Dockhand.

Особенности

280+ MCP Tools, охватывающий API Dockhand — см. docs/coverage.md для точного автоматического обновления покрытия -Система HTTP Transport (MCP Spec 2025-03-26) для хостинга контейнеров Docker Сессионный Auth с авто-регистрацией по 401 ** Поддержка SSE** для развертывания операций (старт, остановка, спуск, перезапуск) Фильтр окружающей среды, применяемый ко всем конечным точкам контейнера/стекла/изображения/сети/объема Docker Ready с многоступенчатой сборкой, некорневым пользователем и проверками здоровья

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

###Докер (рекомендуется)

Заменить [[Т2]]/[[Т3]] парой -e DOCKHAND_API_TOKEN=dh_your-api-token для аутентификации с помощью персонального API Токен вместо этого — см. Аутентификация.

MCP Dockhand

An MCP (Model Context Protocol) server that exposes the Dockhand API as MCP tools. Manage your entire Docker infrastructure through AI assistants.

API coverage: 88.7% of in-scope Dockhand endpoints (282/318) have an MCP tool — see docs/coverage.md for the full, auto-updated breakdown by area.

Dockhand is a Docker management server that connects to multiple Docker hosts via Hawser agents. This MCP server provides full programmatic access to all Dockhand features.

Features

• 280+ MCP Tools covering the Dockhand API — see docs/coverage.md for exact, auto-updated coverage
• Streamable HTTP Transport (MCP Spec 2025-03-26) for Docker container hosting
• Session-based Auth with auto-relogin on 401
• SSE Support for deploy operations (start, stop, down, restart)
• Environment Filter enforced on all container/stack/image/network/volume endpoints
• Docker Ready with multi-stage build, non-root user, and health checks

Quick Start

Docker (recommended)

docker run -d \
  --name mcp-dockhand \
  -p 8080:8080 \
  -e DOCKHAND_URL=https://your-dockhand-server.com \
  -e DOCKHAND_USERNAME=your-username \
  -e DOCKHAND_PASSWORD=your-password \
  ghcr.io/strausmann/mcp-dockhand:latest

Optionally, replace the DOCKHAND_USERNAME/DOCKHAND_PASSWORD pair with -e DOCKHAND_API_TOKEN=dh_your-api-token to authenticate with a personal API token instead — see Authentication.

Docker Compose

services:
  mcp-dockhand:
    image: ghcr.io/strausmann/mcp-dockhand:latest
    container_name: mcp-dockhand
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      - DOCKHAND_URL=https://your-dockhand-server.com
      - DOCKHAND_USERNAME=your-username
      - DOCKHAND_PASSWORD=your-password
      # Optional: use a personal API token instead of the pair above.
      #- DOCKHAND_API_TOKEN=dh_your-api-token

From Source

git clone https://github.com/strausmann/mcp-dockhand.git
cd mcp-dockhand
npm install
npm run build
DOCKHAND_URL=https://your-server.com DOCKHAND_USERNAME=admin DOCKHAND_PASSWORD=secret npm start

(Or, in place of the credential pair, DOCKHAND_API_TOKEN=dh_your-api-token — see Authentication.)

Configuration