MCP 도구로 Dockhand API를 노출하는 MCP (모델 Context Protocol) 서버. AI Assistant를 통해 전체 Docker 인프라 관리.

** API 적용 범위: ** 88.7% in-scope Dockhand endpoints (282/318)에는 MCP 도구가 있습니다. docs/coverage.md]를 볼 수 있습니다.

Dockhand는 Hawser Agent를 통해 여러 Docker 호스트에 연결하는 Docker 관리 서버입니다. 이 MCP 서버는 모든 Dockhand 기능에 대한 전체 프로그램 접근 권한을 제공합니다.

특징

• 280+ MCP Tools Dockhand API 를 덮고 - docs/coverage.md 을 정확하게 알 수 있습니다.
• Streamable HTTP Transport (MCP Spec 2025-03-26) Docker 컨테이너 호스팅
• Session 기반 Auth 자동 로그인 401
• SSE 지원 배포 작업 (스타트, 스톱, 다운, 재시작)
• **환경 필터 ** 모든 컨테이너/stack/image/network/volume endpoints에 시행
• **Docker Ready ** 멀티 스테이지 빌드, 비 루트 사용자 및 건강 검사

빠른 시작

Docker (추천)

선택적으로, DOCKHAND_USERNAME/DOCKHAND_PASSWORD] 쌍을 -e DOCKHAND_API_TOKEN=dh_your-api-token 개인 API로 인증 대신 토큰 — Authentication을 참조하십시오.

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