Build MCP

🚀 Docker Build MCP TypeScript Server

このプロジェクトは、MCP（modelcontextprotocol）標準を完全にサポートするDocker Build MCPサーバーです。MCPクライアントとの互換性やDockerイメージの自動管理など、多くの便利な機能を備えています。

✨ 主な機能

• MCP標準の完全サポート: Cursor、ClaudeなどのMCPクライアントでのtool discovery/実行が100%互換性があります。
• Dockerイメージ管理の自動化: build、run、stop、rm、rmi、pushなどのDocker CLIの主要機能をAPIで提供します。
• SSE（Server - Sent Events）およびstdioモードのサポート
• 高い拡張性のある構造: 各Dockerコマンドが独立したツールとして実装されており、保守と拡張が容易です。
• 実行コマンドと結果のログ: すべてのDockerコマンドの実行時に、コマンドと結果がコンソールに出力されます。

📁 ディレクトリ構造

./
  ├── dist/                # ビルド結果
  ├── node_modules/        # 依存モジュール
  ├── src/
  │   ├── config/          # サーバーとツールの設定
  │   ├── models/          # 型/スキーマの定義
  │   ├── prompts/         # MCPプロンプトハンドラー
  │   ├── resources/       # リソースハンドラー
  │   ├── tools/           # Docker関連のMCPツール (build, run, stop, rm, rmiなど)
  │   ├── utils/           # ユーティリティ関数
  │   ├── http - server.ts # HTTPサーバーのエントリポイント
  │   └── index.ts         # MCPサーバーのエントリポイント
  ├── tests/               # テストコード
  ├── package.json         # プロジェクトのメタデータ/スクリプト
  ├── tsconfig.json        # TypeScriptの設定
  └── vitest.config.ts     # テスト設定

🛠️ 主要機能とサポートツール

• docker_build: 複数のファイルをコンテキストとして受け取り、Dockerイメージをビルドします。
• docker_run: 希望のオプションでコンテナを作成して実行します。
• docker_ps: 実行中/全コンテナのリストを取得します（allオプションをサポート）。
• docker_stop, docker_stop_multi: コンテナ（複数可）を停止します。
• docker_rm, docker_rm_multi: コンテナ（複数可）を削除します（削除前に自動的に停止します）。
• docker_images: ローカルのイメージリストを取得します。
• docker_rmi, docker_rmi_multi: イメージ（複数可）を削除します。
• docker_push: タグ付けされたイメージをレジストリにプッシュします。
• docker_login: Dockerレジストリにログインします。
• docker - inspect: コンテナ/イメージの詳細情報を取得します。
• docker - container - prune, docker - image - prune, docker - network - prune, docker - volume - prune: 不要なリソースを一括で削除します。

📦 インストール

1. 依存関係のインストール

npm install

2. 開発サーバーの起動（SSEモード）

ENABLE_UNSAFE_SSE_TRANSPORT=1 npm run dev

3. ビルドとデプロイ

npm run build
npm start

💻 使用例

基本的な使用法

• MCPクライアントでtool discoveryを通じて上記のツールを自動的に認識/実行できます。
• 各ツールはchild_processでDocker CLIを直接呼び出し、実際のDocker環境と同じように動作します。

🧪 テスト

• tests/ディレクトリには各ツールのテストコードが含まれています。
• Vitestベースのテストがサポートされています。

🤝 貢献と問い合わせ

このプロジェクトは拡張や貢献を歓迎します。MCP標準、Docker自動化、追加機能に関する問い合わせはいつでもIssueやPRを通じて行ってください。

実際のbuild/push/runなどはchild_processでDocker CLIを呼び出します。

🐳 DinD（Docker - in - Docker）完全分離型MCPサーバーの本番デプロイガイド

1. 最新イメージのビルドとDocker Hubへのプッシュ

docker build -t ekdh600/build - mcp:latest .
docker push ekdh600/build - mcp:latest

2. 最新コードのGitコミットとプッシュ

cd docker - build - mcp - ts
git add .
git commit -m "docs: DinD構造とKubernetes対応の最新化"
git push

3. DinDベースの完全分離型コンテナの起動（Kubernetes対応）

• ホストのDockerソケットをマウントせず、内部のdockerdのみを使用
• Kubernetes環境でも同じように動作します。

docker run --privileged --name build - mcp -d -p 3000:3000 ekdh600/build - mcp:latest

• 内部のdockerdが自動的に起動し、MCPサーバーが0.0.0.0:3000で待機します。
• MCPツール（docker_ps, docker_runなど）はコンテナ内のDocker環境のみを制御します（ホストと完全に分離）。
• カーソル/クラウド/Kubernetes環境でも同じようにMCPサーバーとして登録して使用できます。

4. MCPツールの本番使用例（カーソル/クラウド）

• MCPサーバーのアドレス: http://<ホストIP>:3000
• カーソルでMCPサーバーを登録した後、docker_ps, docker_runなどを使用できます。
• 作成/取得されるコンテナはすべてDinD内部環境にのみ存在します。