local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables container and Docker Compose stack management, including creation of standalone containers, deployment of compose stacks, retrieval of container logs, and listing of container status and information.

🐳 도커-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

🚀 빠른 시작

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"
      ]
    }
  }
}

🛠️ 개발

로컬 설정

저장소를 복제합니다.

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

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

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

종속성 설치:

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 컨테이너를 나열합니다

{}

🚧 현재 제한 사항

컨테이너에 대한 내장 환경 변수 지원이 없습니다.
볼륨 관리 없음
네트워크 관리 없음
컨테이너 상태 점검 없음
컨테이너 재시작 정책 없음
컨테이너 리소스 제한 없음

🤝 기여하기

docker-mcp 에서 저장소를 포크합니다.
기능 브랜치를 생성하세요
변경 사항을 커밋하세요
지점으로 밀어 넣기
풀 리퀘스트 열기

📜 라이센스

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

✨ 저자

Alex Andru - 초기 작업 | 핵심 기여자 - @QuantGeekDev
Ali Sadykov - 초기 작업 | 핵심 기여자 - @md-archive

❤️로 만들었습니다

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools