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にリダイレクトするため、出力は常にキャプチャされます。