🐳 도커-mcp

Docker 작업을 위한 강력한 MCP(Model Context Protocol) 서버로, 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

Related MCP server: MCP Development Server

🚀 빠른 시작

Claude Desktop 앱에서 이 기능을 시도하려면 Claude 설정 파일에 다음을 추가하세요.

지엑스피1

Smithery를 통해 설치

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

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

필수 조건

• UV(패키지 관리자)

• 파이썬 3.12+

• Docker 데스크톱 또는 Docker 엔진

• 클로드 데스크탑

설치

클로드 데스크톱 구성

Claude Desktop 구성 파일에 서버 구성을 추가합니다.

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

{
  "mcpServers": {
    "docker-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path-to-docker-mcp>",
        "run",
        "docker-mcp"
      ]
    }
  }
}

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

🛠️ 개발

로컬 설정

1. 저장소를 복제합니다.

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

2. 가상 환경을 만들고 활성화하세요.

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

3. 종속성 설치:

uv sync

🔍 디버깅

디버깅을 위해 MCP Inspector를 실행합니다.

npx @modelcontextprotocol/inspector uv --directory <path-to-docker-mcp> run docker-mcp

검사기는 디버깅 인터페이스에 액세스할 수 있는 URL을 제공합니다.

📝 사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

컨테이너 생성

독립 실행형 Docker 컨테이너를 생성합니다.

{
    "image": "image-name",
    "name": "container-name",
    "ports": {"80": "80"},
    "environment": {"ENV_VAR": "value"}
}

배포-작성

Docker Compose 스택을 배포합니다.

{
    "project_name": "example-stack",
    "compose_yaml": "version: '3.8'\nservices:\n  service1:\n    image: image1:latest\n    ports:\n      - '8080:80'"
}

get-logs

특정 컨테이너에서 로그를 검색합니다.

{
    "container_name": "my-container"
}

목록 컨테이너

모든 Docker 컨테이너를 나열합니다

{}

🚧 현재 제한 사항

• 컨테이너에 대한 내장 환경 변수 지원이 없습니다.

• 볼륨 관리 없음

• 네트워크 관리 없음

• 컨테이너 상태 점검 없음

• 컨테이너 재시작 정책 없음

• 컨테이너 리소스 제한 없음

🤝 기여하기

1. docker-mcp 에서 저장소를 포크합니다.

2. 기능 브랜치를 생성하세요

3. 변경 사항을 커밋하세요

4. 지점으로 밀어 넣기

5. 풀 리퀘스트 열기

📜 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

✨ 저자

• Alex Andru - 초기 작업 | 핵심 기여자 - @QuantGeekDev

• Ali Sadykov - 초기 작업 | 핵심 기여자 - @md-archive

❤️로 만들었습니다