FastMCPでPythonで書かれたセキュリティ強化されたModel Context Protocol(MCP)サーバーで、ローカルのLLMエージェント(Claude Desktop、Claude Code)を厳格なゼロトラスト境界のもとDockerデーモンに接続します。

コア能力と安全対策

• デフォルトで読み取り専用: ミューテーションツール(safe_restart_container)は、明示的にGUARDIAN_ALLOW_WRITE=trueが設定されていない限り、Dockerソケットに触れる前に呼び出しを拒否します。
• 標準ID解決: 正則表現否認リストを評価する前に、コンテナIDをDockerの内部標準名に解決し、十六進進IDによる回避を防ぎます。
• Credential & Secret Redaction: inspect_container は環境変数の値をすべて削除し、LLMプロンプトの漏洩を防ぐために変数キーのみを返します。
• 隔離されたStdio JSON-RPC: 厳格なログ分離により、非構造化のstdout書き込みがゼロとなり、MCPクライアントでのJSON-RPCストリーム破損を防ぎます。
• 制限されたデーモンタイムアウト: すべてのDocker API呼び出しはGUARDIAN_DOCKER_TIMEOUT(デフォルト5秒)で制限されているため、ウェッジまたは欠損デーモンはセッションをハングする代わりに構造化されたdaemon_unavailableエラーを返します。

クイックスタート

前提条件

• Python 3.10+
• Docker Engine / Docker Desktop
• 'mcp>=1.0。

Docker MCP Guardian

A security-hardened Model Context Protocol (MCP) server written in Python with FastMCP that connects local LLM agents (Claude Desktop, Claude Code) to the Docker daemon with strict zero-trust boundaries.

Core Capabilities & Safeguards

• Read-Only by Default: Mutation tools (safe_restart_container) reject calls before touching the Docker socket unless GUARDIAN_ALLOW_WRITE=true is explicitly set.
• Canonical ID Resolution: Resolves container IDs to Docker’s internal canonical name before evaluating regex denylists, preventing evasion via hex IDs.
• Credential & Secret Redaction: inspect_container strips all environment variable values, returning only variable keys to prevent LLM prompt leakage.
• Isolated Stdio JSON-RPC: Strict logging separation ensures zero unstructured stdout writes, preventing JSON-RPC stream corruption in MCP clients.
• Bounded Daemon Timeouts: Every Docker API call is capped by GUARDIAN_DOCKER_TIMEOUT (default 5s), so a wedged or missing daemon returns a structured daemon_unavailable error instead of hanging the session.

Quickstart

Prerequisites

• Python 3.10+
• Docker Engine / Docker Desktop
• mcp>=1.0.0,<2 (pinned to FastMCP API)

Local Installation

git clone https://github.com/SivaSaiKrishnaSuryadevara/docker-mcp-guardian.git
cd docker-mcp-guardian
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pytest tests/ -v

Connect to Claude Code

claude mcp add docker-guardian -- "$PWD/.venv/bin/python" "$PWD/server.py"

For Claude Desktop, add the same interpreter and script paths (absolute) under mcpServers in claude_desktop_config.json.

Configuration

Docker endpoint resolution