Build MCP

🚀 Docker Build MCP TypeScript Server

本項目是一個完全遵循 MCP（模型上下文協議）標準的 Docker Build MCP 服務器。它能為用戶提供標準化、自動化的 Docker 鏡像管理服務，藉助 MCP 標準實現與各類客戶端的無縫對接，極大提升 Docker 操作的便捷性與效率。

✨ 主要特性

• 💯 完全支持 MCP 標準：與 Cursor、Claude 等 MCP 客戶端在工具發現和執行方面 100% 兼容。
• ⚙️ 自動化 Docker 鏡像管理：通過 API 提供 build、run、stop、rm、rmi、push 等 Docker CLI 的主要功能。
• 📡 支持 SSE（服務器發送事件）和 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 客戶端可以通過工具發現自動識別和執行上述工具。
• 每個工具通過子進程直接調用 Docker CLI，與實際 Docker 環境的操作相同。

🧪 測試

• tests/ 目錄中包含每個工具的測試代碼。
• 支持基於 vitest 的測試。

🤝 貢獻與諮詢

本項目歡迎擴展和貢獻。如果您有關於 MCP 標準、Docker 自動化或額外功能的問題，請隨時通過 Issue 或 PR 提出。

實際上，build、push、run 等操作是通過子進程調用 Docker CLI 完成的。

🐳 DinD（Docker 內 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 環境（與主機完全隔離）。
• 可以在 Cursor、雲環境或 Kubernetes 環境中註冊並使用 MCP 服務器。

4. MCP 工具實戰使用示例（Cursor/雲環境）

• MCP 服務器地址：http://<主機 IP>:3000
• 在 Cursor 中註冊 MCP 服務器後，即可使用 docker_ps、docker_run 等工具。
• 創建和查詢的容器都僅存在於 DinD 內部環境中。