🐳 도커-mcp

파이썬 3.12 라이센스: MIT 코드 스타일: 검정색 대장간 배지

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: Docker MCP 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" ] } } }

🛠️ 개발

로컬 설정

저장소를 복제합니다.

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

❤️로 만들었습니다

One-click Deploy

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

docker-mcp