🐳 docker-mcp

👁 Python 3.12
👁 ライセンス: MIT
👁 コードスタイル: 黒
👁 鍛冶屋のバッジ

Docker 操作用の強力な Model Context Protocol (MCP) サーバー。Claude AI を通じてシームレスなコンテナーと Compose スタックの管理を可能にします。

✨ 特徴

• 🚀 コンテナの作成とインスタンス化

• 📦 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: MCP Development Server

🚀 クイックスタート

Claude デスクトップ アプリでこれを試すには、claude 構成ファイルに以下を追加します。

{
 "mcpServers": {
 "docker-mcp": {
 "command": "uvx",
 "args": [
 "docker-mcp"
 ]
 }
 }
}

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Docker MCP を自動的にインストールするには:

npx @smithery/cli install docker-mcp --client claude

前提条件

• UV（パッケージマネージャー）

• Python 3.12以上

• DockerデスクトップまたはDockerエンジン

• クロードデスクトップ

インストール

クロードデスクトップ構成

Claude Desktop 構成ファイルにサーバー構成を追加します。

MacOS : ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows : %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"
 ]
 }
 }
}

🛠️ 開発

ローカルセットアップ

1. リポジトリをクローンします。

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

2. 仮想環境を作成してアクティブ化します。

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

3. 依存関係をインストールします:

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

ログを取得する

特定のコンテナからログを取得します

{
 "container_name": "my-container"
}

リストコンテナ

すべてのDockerコンテナを一覧表示します

{}

🚧 現在の制限

• コンテナの組み込み環境変数サポートなし

• ボリューム管理なし

• ネットワーク管理なし

• コンテナのヘルスチェックなし

• コンテナ再起動ポリシーなし

• コンテナリソースの制限なし

🤝 貢献する

1. docker-mcpからリポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. ブランチにプッシュする

5. プルリクエストを開く

📜 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

✨ 著者

• Alex Andru -初期作業 | コア貢献者- @QuantGeekDev

• Ali Sadykov -初期作業 | コア貢献者- @md-archive

❤️で作りました

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• create-containerC
• deploy-composeC
• get-logsC
• list-containersB