MCP ツールとして Dockhand API を公開する MCP (Model Context Protocol) サーバー。 AI アシスタントを通じて Docker インフラストラクチャ全体を管理します。

** API のカバレッジ:** スコープの Dockhand エンドポイントの 88.7% (282/318) には MCP ツールが搭載されているので、docs/coverage.md を参照してください。

Dockhand は、Hawser エージェント経由で複数の Docker ホストに接続する Docker 管理サーバーです。 このMCPサーバーは、全てのDockhand機能にフルなプログラマティックなアクセスを提供します。

##特徴

• Dockhand API を覆う280+ MCP Tools — 完全自動更新されたカバレッジの docs/coverage.md を参照してください
• Dockerコンテナのホスティングに便利なHTTPトランスポート**(MCPスペック2025-03-26) -Session-based Auth および 401 の自動ログイン
• デプロイ操作(起動、停止、ダウン、再起動)のSSEサポート
• 環境フィルターは、すべてのコンテナ/スタック/画像/ネットワーク/ボリュームエンドポイントで強制されます。 -Docker Ready はマルチステージビルド、root 以外のユーザー、および健康チェック付き

クイックスタート

Docker (推奨)

オプションで、[DOCKHAND_USERNAME/[DOCKHAND_PASSWORD]]のペアを置換します。 [-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