Docker MCP

SSH를 통한 원격 Docker 관리 — GitHub Copilot 세션을 위한 로컬 MCP 서버로 노출됩니다.

서버 측 구성 요소가 필요하지 않습니다. MCP는 로컬에서 실행되며 SSH를 통해 원격 호스트에 접속하여 Docker 명령을 실행합니다.

도구

설정

1. 저장소 복제

git clone git@github.com:Isak-Landin/mcp-docker-engine.git ~/mcp-docker-engine
cd ~/mcp-docker-engine

원하는 디렉토리에 복제할 수 있습니다. ~/mcp-docker-engine을 원하는 경로로 바꾸고, 5단계에서도 동일한 경로를 사용하세요.

2. 의존성 설치

sudo apt install python3.12-venv
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

3. SSH 대상 구성

cp config.example.json config.json
# Edit config.json with your server details

config.json 필드:

{
  "host": "your-server.example.com",
  "user": "ubuntu",
  "key_path": "~/.ssh/id_rsa",
  "port": 22
}

런타임에 구성 경로 재정의:

DOCKER_MCP_CONFIG=/other/path/config.json .venv/bin/python3 server.py

4. SSH 액세스 확인

ssh -i ~/.ssh/id_rsa ubuntu@your-server.example.com docker ps

5. GitHub Copilot에 등록

복제한 절대 경로를 사용하세요. ~/mcp-docker-engine을 사용했다면 echo ~/mcp-docker-engine을 실행하여 전체 경로를 확인한 후 아래에 대입하세요.

MCP 서버 구성

GitHub Copilot CLI (~/.config/github-copilot/mcp.json) — 기존 mcpServers 객체에 추가하거나 파일을 생성하세요:

"docker-mcp": {
  "command": "/your/path/to/mcp-docker-engine/.venv/bin/python3",
  "args": ["/your/path/to/mcp-docker-engine/server.py"]
}

VS Code / Copilot in VS Code (.vscode/mcp.json 또는 사용자 설정) — 기존 servers 객체에 추가하거나 파일을 생성하세요:

"docker-mcp": {
  "type": "stdio",
  "command": "/your/path/to/mcp-docker-engine/.venv/bin/python3",
  "args": ["/your/path/to/mcp-docker-engine/server.py"]
}

Copilot 지침

instructions.md에는 26개 도구 모두에 대한 도구 사용 예시가 포함되어 있습니다. 다음을 수행할 수 있습니다:

• 기존 Copilot 지침 파일(예: .github/copilot-instructions.md 또는 작업 공간 지침)에 내용을 추가하세요.

• 아직 지침 파일이 없다면 있는 그대로 사용하세요.

참고 사항

• SSH 연결은 StrictHostKeyChecking=accept-new를 사용합니다. 알려진 호스트에 대해 안전하며, 키 변경 시 경고가 표시됩니다.

• docker_build와 docker_pull은 5~10분의 타임아웃을 사용합니다. 필요에 따라 server.py에서 timeout을 조정하세요.

• Compose 도구의 경우, project_dir은 docker-compose.yml이 포함된 원격 경로입니다.

• docker_logs와 docker_exec는 stderr을 stdout으로 리다이렉트하여 출력이 항상 캡처되도록 합니다.