Docker Mcp Server

Docker MCP Server

統一されたインターフェースを通じて高度な Docker 操作を提供する、包括的な Model Context Protocol（MCP）サーバーです。このサーバーは、強力な 16 個の Docker MCP ツールと便利な 25 個以上の CLI エイリアスを組み合わせ、開発者、DevOps エンジニア、システム管理者向けの完全な Docker ワークフローソリューションを実現します。

🌟 Docker MCP Server の特長

Docker MCP Server は単なる Docker ラッパーではありません。Docker 操作をより直感的、安全、効率的にするために設計された、完全な Docker ワークフロー拡張システムです。

🎯 統一されたインターフェース

• MCP プロトコル統合：MCP 対応のツールや IDE とシームレスに連携します
• CLI の利便性：一般的な Docker ワークフロー向けに厳選した 25 個以上のエイリアスを用意しています
• 一貫した API：すべての操作が同じパターンと規約に従います
• クロスプラットフォーム：Linux、macOS、Windows 環境を完全にサポートします

🔒 セキュリティを最優先した設計

• Docker によるセキュリティ管理：最高水準のセキュリティを実現するため、パスワードに関するすべての操作を Docker デーモンが処理します
• パスワードの露出ゼロ：パスワードがコマンド履歴、プロセス一覧、引数に表示されることはありません
• トークン認証のサポート：Personal Access Token とサービスアカウントを完全にサポートします
• 柔軟なレジストリ対応：Docker Hub、AWS ECR、Azure ACR、Google GCR、カスタムレジストリに安全にログインできます
• CI/CD のセキュリティ：自動デプロイパイプラインで安全な stdin によるパスワード入力が可能です
• 権限管理：Docker デーモンの権限と認証情報の保存を適切に処理します

🚀 開発者エクスペリエンス

• 包括的なヘルプシステム：各コマンドに --help で確認できる詳細なドキュメントが含まれています
• スマートなデフォルト設定：一般的なユースケースに適したデフォルト設定を用意しています
• エラーの防止：破壊的な操作に対する安全性チェックと確認プロンプトを組み込んでいます
• 豊富な出力：明確なステータス表示を備えた、整形済みのカラー出力です

📊 高度な操作

• コンテナーのライフサイクル全体に対応：ビルドから公開まで、レジストリを幅広くサポートします
• 複数コンテナーの管理：サービスオーケストレーションに Docker Compose を統合します
• レジストリへの公開：マルチプラットフォーム対応と自動化ワークフローを備えた高度なイメージ公開機能です
• ネットワークとボリュームの管理：高度なネットワーク操作とストレージ操作に対応します
• システムのメンテナンス：複数の安全レベルを備えたインテリジェントなクリーンアップツールです
• 開発ワークフロー：開発環境向けの専用コマンドを用意しています

📦 インストール

MCP クライアントのクイックセットアップ

この設定を MCP クライアントの設定に追加してください。

{
  "mcpServers": {
    "docker-mcp-server": {
      "command": "npx",
      "args": ["-y", "@0xshariq/docker-mcp-server@latest"]
    }
  }
}

追加先：

• Claude Desktop：claude_desktop_config.json
• VS Code Cline：.vscode/mcp.json
• その他の MCP クライアント：各クライアントの設定ドキュメントをご確認ください

簡単なインストール（推奨）

Docker MCP Server をグローバルにインストールすると、システム上のどこからでも使用できます。

# Install with npm
npm install -g @0xshariq/docker-mcp-server

# Or install with pnpm (faster)
pnpm add -g @0xshariq/docker-mcp-server

# Verify installation works
docker-mcp-server --version
dlist                        # List all available commands

これで完了です。25 個すべての CLI エイリアスがシステム全体で使用できるようになります。

開発者向け

サーバーに貢献する場合やカスタマイズする場合は、次の手順に従ってください。

# Clone and setup
git clone https://github.com/0xshariq/docker-mcp-server.git
cd docker-mcp-server
npm install
npm run build

# Test locally
npm link                     # Makes commands available globally
dlist                       # Verify it works

事前に必要なもの

インストールする前に、次のものがそろっていることを確認してください。

• Node.js 18+ - こちらからダウンロード
• Docker - Docker をインストール
• npm（Node.js に付属）

インストール済みかどうかを確認してください。

node --version              # Should show v18 or higher
docker --version           # Should show Docker version

🚀 クイックスタート

試してみる

インストール後、次のコマンドを実行して Docker MCP Server の動作を確認してください。

# See all available commands
dlist

# Basic Docker operations
dps                         # List running containers
dimages                     # List Docker images
drun -it ubuntu bash        # Run interactive Ubuntu container

# Advanced operations
dcompose up -d              # Start Docker Compose services
dlogin                      # Login to Docker registries
dpublish myapp:v1.0         # Publish image to registry

📚 ドキュメント

詳細はこちら：

• 📖 基本コマンド - 8 つの基本的な Docker 操作を簡単に実行
• ⚡ 高度なコマンド - 複雑なワークフロー向けの強力なツール 14 種類
• 🔧 MCP サーバーのセットアップ - Claude Desktop やその他の MCP クライアントに接続

🎯 利用できる機能

基本コマンド（エイリアス 8 種類）

日常的に使うシンプルな Docker 操作を、すぐに実行できます。

• コンテナ管理：コンテナの一覧表示、実行、停止、詳細確認
• イメージ操作：Docker イメージのプル、ビルド、管理
• ログとデバッグ：ログの表示、コンテナ内でのコマンド実行

高度なコマンド（エイリアス 14 種類）

複雑な Docker ワークフロー向けの強力なツールです。

• 複数コンテナのアプリ：Docker Compose を完全に統合
• レジストリ操作：Docker Hub、GitHub、AWS などへの安全なログインとイメージの公開
• ネットワークとストレージ：高度なネットワーク機能とボリューム管理
• システムのメンテナンス：インテリジェントなクリーンアップと環境管理
• 開発ツール：開発環境に特化したワークフロー

🔧 MCP サーバーのセットアップ

Claude Desktop の場合

1. Claude の設定ファイルを確認します：

   • Linux：~/.config/claude-desktop/claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 次の内容を設定ファイルに追加します：

   {
     "mcpServers": {
       "docker": {
         "command": "node",
         "args": ["/path/to/docker-mcp-server/dist/index.js"]
       }
     }
   }
   

3. Claude Desktop を再起動すると、Docker ツールを利用できるようになります。

汎用起動スクリプト

起動スクリプトを使うと、任意の MCP クライアントで自動セットアップできます。

./start-mcp.sh              # Automatic environment setup
./start-mcp.sh --help       # See all options

対応クライアント： Claude Desktop、Cursor IDE、Continue（VS Code）、Open WebUI など

🏗️ プロジェクト構成

docker-mcp-server/
├── src/                    # TypeScript source code
├── bin/                    # CLI alias scripts
│   ├── basic/             # 8 basic Docker operations
│   └── advanced/          # 14 advanced Docker operations
├── help/                  # Documentation for all commands
├── start-mcp.sh          # Universal MCP server startup script
├── docker-cli.js         # Main CLI wrapper
└── dist/                 # Compiled JavaScript output

📚 ドキュメント一覧：

• 基本コマンドのリファレンス - 8 つの基本的な Docker 操作
• 高度なコマンドのリファレンス - 強力なワークフローツール 14 種類
• 利用可能な全コマンド - 構文と使用例の完全な一覧

⚡ 利用可能な全コマンド

基本操作（コマンド 8 種類）

日常的に使う基本的な Docker 操作です。

• dimages、dps、dpsa、dpull、drun、dlogs、dexec、dbuild

高度な操作（コマンド 14 種類）

複雑なワークフロー向けの強力なツールです。

• dcompose、dup、ddown、dnetwork、dvolume、dinspect、dprune
• dlogin、dlogout、dpublish、dbridge、ddev、dclean、dstop、dreset

ユーティリティコマンド（3 種類）

• docker-mcp-server、dms、dlist

📖 詳細なドキュメント： dlist コマンドを使うか、上記の README ファイルを確認してください。

🔧 開発

コントリビューター向け

# Setup development environment
git clone https://github.com/0xshariq/docker-mcp-server.git
cd docker-mcp-server
npm install

# Development commands
npm run dev                 # Build and watch for changes
npm run build              # Build TypeScript
npm run start              # Start MCP server
npm run clean              # Clean build files

🧪 テスト

クイックテスト

# After installation, test these commands
dlist                      # Should show all 25 commands
dps                        # Should list containers
dimages                    # Should list images

MCP 統合のテスト

./start-mcp.sh             # Should start without errors

🆘 よくある問題

「コマンドが見つかりません」

# Make sure npm global bin is in your PATH
echo $PATH | grep $(npm config get prefix)

# If not found, add this to ~/.bashrc or ~/.zshrc:
export PATH="$(npm config get prefix)/bin:$PATH"

「Docker デーモンが実行されていません」

# Check Docker status
docker info

# Start Docker (Linux)
sudo systemctl start docker

# Start Docker Desktop (macOS/Windows)
# Launch the Docker Desktop app

「アクセスが拒否されました」

# Add yourself to docker group (Linux)
sudo usermod -aG docker $USER
# Then logout and login again

📋 詳細情報：

• すべてのコマンドについては dlist --help を確認してください
• 詳しい解決方法はトラブルシューティングガイドを参照してください

---

📄 ライセンス

ISC License

👨‍💻 作者

Sharique Chaudhary（@0xshariq）

🤝 コントリビューション

コントリビューションを歓迎します。次の手順でお願いします。

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をテストします
4. プルリクエストを送信します

🔗 リンク

• GitHub リポジトリ
• NPM パッケージ
• 問題とサポート

---

✨ Docker MCP Server - Docker ワークフローを、誰もが簡単かつ強力に使えるようにします。