Docker MCP

Remote-Docker-Verwaltung über SSH — bereitgestellt als lokaler MCP-Server für GitHub Copilot-Sitzungen.

Es ist keine serverseitige Komponente erforderlich. Das MCP läuft lokal und verbindet sich per SSH mit dem Remote-Host, um Docker-Befehle auszuführen.

Werkzeuge

Einrichtung

1. Repository klonen

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

Sie können es in ein beliebiges Verzeichnis klonen. Ersetzen Sie ~/mcp-docker-engine durch Ihren bevorzugten Pfad — verwenden Sie einfach denselben Pfad in Schritt 5.

2. Abhängigkeiten installieren

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

3. SSH-Ziel konfigurieren

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

config.json Felder:

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

Konfigurationspfad zur Laufzeit überschreiben:

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

4. SSH-Zugriff verifizieren

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

5. Bei GitHub Copilot registrieren

Verwenden Sie den absoluten Pfad zu Ihrem Klon. Wenn Sie ~/mcp-docker-engine verwendet haben, erweitern Sie ihn: Führen Sie echo ~/mcp-docker-engine aus, um den vollständigen Pfad zu erhalten, und ersetzen Sie ihn dann unten.

MCP-Server-Konfiguration

GitHub Copilot CLI (~/.config/github-copilot/mcp.json) — fügen Sie es Ihrem bestehenden mcpServers-Objekt hinzu oder erstellen Sie die Datei:

"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 oder Benutzereinstellungen) — fügen Sie es Ihrem bestehenden servers-Objekt hinzu oder erstellen Sie die Datei:

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

Copilot-Anweisungen

instructions.md enthält Beispiele für die Verwendung aller 26 Werkzeuge. Sie können:

• Den Inhalt zu Ihrer bestehenden Copilot-Anweisungsdatei hinzufügen (z. B. .github/copilot-instructions.md oder Ihre Arbeitsbereich-Anweisungen)

• Es unverändert verwenden, falls Sie noch keine Anweisungsdatei haben

Hinweise

• Die SSH-Verbindung verwendet StrictHostKeyChecking=accept-new - sicher für bekannte Hosts, warnt bei Schlüsseländerungen.

• docker_build und docker_pull verwenden ein Timeout von 5-10 Minuten; passen Sie bei Bedarf timeout in server.py an.

• Für Compose-Werkzeuge ist project_dir der Remote-Pfad, der die docker-compose.yml enthält.

• docker_logs und docker_exec leiten stderr nach stdout um, sodass die Ausgabe immer erfasst wird.