Docker 운영을 위한 강력한 모델 컨텍스트 프로토콜(MCP) 서버로, Claude AI를 통한 원활한 컨테이너 및 컴포즈 스택 관리를 가능하게 합니다.

✨ 특징

• 🚀 컨테이너 생성 및 인스턴스화
• 📦 Docker Compose 스택 배포
• 🔍 컨테이너 로그 회수
• 📊 컨테이너 목록 및 상태 모니터링

🎬 데모

Docker Compose 스택 배포

https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278

컨테이너 로그 분석

https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934

🚀 퀵스타트

Claude 데스크톱 앱에서 시도해보려면, Claude 설정 파일에 이 내용을 추가하세요:

Smithery를 통해 설치 중

Smithery를 통해 Claude Desktop용 Docker MCP를 자동으로 설치하려면:

전제 조건

• UV (패키지 관리자)
• 파이썬 3.12+
• 도커 데스크톱 또는 도커 엔진
• 클로드 데스크톱

설치

Claude 데스크탑 구성

서버 설정을 Claude Desktop 설정 파일에 추가하세요:

맥OS: ~/Library/Application\ Support/Claude/claude_desktop_config.json 윈도우: %APPDATA%/Claude/claude_desktop_config.json

💻 개발 구성

🚀 생산 구성

🐳 docker-mcp

A powerful Model Context Protocol (MCP) server for Docker operations, enabling seamless container and compose stack management through Claude AI.

✨ Features

• 🚀 Container creation and instantiation
• 📦 Docker Compose stack deployment
• 🔍 Container logs retrieval
• 📊 Container listing and status monitoring

🎬 Demos

Deploying a Docker Compose Stack

https://github.com/user-attachments/assets/b5f6e40a-542b-4a39-ba12-7fdf803ee278

Analyzing Container Logs

https://github.com/user-attachments/assets/da386eea-2fab-4835-82ae-896de955d934

🚀 Quickstart

To try this in Claude Desktop app, add this to your claude config files:

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uvx",
      "args": [
        "docker-mcp"
      ]
    }
  }
}

Installing via Smithery

To install Docker MCP for Claude Desktop automatically via Smithery:

npx @smithery/cli install docker-mcp --client claude

Prerequisites

• UV (package manager)
• Python 3.12+
• Docker Desktop or Docker Engine
• Claude Desktop

Installation

Claude Desktop Configuration

Add the server configuration to your Claude Desktop config file:

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

🛠️ Development

Local Setup

1. Clone the repository:

git clone https://github.com/QuantGeekDev/docker-mcp.git
cd docker-mcp

2. Create and activate a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

uv sync

🔍 Debugging

Launch the MCP Inspector for debugging:

npx @modelcontextprotocol/inspector uv --directory  run docker-mcp

The Inspector will provide a URL to access the debugging interface.

📝 Available Tools

The server provides the following tools:

create-container

Creates a standalone Docker container