Docker MCP

🚀 Docker MCP 服務

Docker MCP 服務是一款強大的模型上下文協議服務器，可在 Docker 容器中執行代碼，並將結果返回給 Claude 等語言模型（LLM）。它支持隔離的代碼執行、多語言支持以及與各類包管理工具集成等多種功能，為開發者提供了高效、可靠的代碼執行環境。

🚀 快速開始

啟動 MCP 服務，只需執行以下命令：

python src/docker_mcp.py

啟動後，訪問 http://localhost:8090 即可打開 MCP 綁定的控制檯。

✨ 主要特性

• 隔離的代碼執行：藉助 Docker 容器，確保代碼在獨立環境中運行，避免相互干擾。
• 多語言支持：支持 Python、Node.js 等多種編程語言，滿足不同開發需求。
• 複雜腳本支持：能夠處理複雜的腳本和任務，應對多樣化的業務場景。
• 包管理：內置對 pip、npm、apt-get 和 apk 的支持，可自動檢測並使用合適的包管理工具。
• 容器管理：提供創建、監控和清理 Docker 容器的功能，方便開發者進行容器操作。
• 健壯的錯誤處理：具備超時檢測和恢復機制，確保任務可靠執行，提高系統穩定性。
• 彩色輸出：通過終端顏色編碼提升用戶體驗，使信息展示更加直觀。

📦 安裝指南

安裝需求

• Python 版本要求：必須安裝 Python 3.6 或更高版本。
• Docker 安裝：請確保 Docker 已正確安裝並運行（可通過 docker --version 命令驗證）。
• fastmcp 庫：需要安裝 fastmcp 庫以支持與 LLM 的集成。

安裝步驟

1. 克隆代碼倉庫：

   git clone https://github.com/your-repository.git
   

2. 創建虛擬環境並激活：

   python -m venv venv
   source venv/bin/activate  # 在 Linux/Mac 上
   venv\Scripts\activate     # 在 Windows 上
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

💻 使用示例

基礎用法

列出容器

查看所有運行中的 Docker 容器：

list_containers [--all]

• --all：顯示所有容器，包括已停止的容器。

創建新容器

創建並啟動一個新的 Docker 容器：

create_container [-i IMAGE] [-- privileged|nonPrivileged] [COMMAND]

• IMAGE：指定鏡像，默認為 python:3.8-slim。
• privileged 或 nonPrivileged：設置容器的權限模式。
• COMMAND：指定要執行的命令。

執行命令

在現有容器中執行命令：

execute_command [-c CONTAINER_ID] [-t COMMAND]

• CONTAINER_ID：指定目標容器的 ID。
• COMMAND：要執行的具體命令。

刪除容器

刪除指定的 Docker 容器：

remove_container [-c CONTAINER_ID] [--volumes]

• CONTAINER_ID：指定要刪除的容器 ID。
• --volumes：同時刪除與容器關聯的卷。

高級用法

基本工作流程示例

1. 列出所有容器：

   list_containers
   

2. 創建一個 Python 容器並執行命令：

   create_container -i python:3.8-slim -c "echo 'Hello, Docker!'" --nonPrivileged
   

3. 執行完成後，刪除容器：

   remove_container [-c CONTAINER_ID]
   

Python 數據分析示例

1. 創建一個 Node.js 容器並安裝依賴項：

   create_container -i node:16 --privileged npm install express axios
   

2. 執行腳本：

   execute_command [-c CONTAINER_ID] node script.js
   

📚 詳細文檔

包管理器支持

服務自動檢測並使用適合的包管理工具：

• Python：使用 pip。
• Node.js：使用 npm。
• Debian/Ubuntu：使用 apt-get。
• Alpine：使用 apk。

對於無法從鏡像名稱推斷包管理器的情況，系統會嘗試檢測可用的包管理工具。

與 LLM 的集成

通過 fastmcp 庫支持與 Claude 等語言模型的集成，實現更高級的功能擴展。

⚠️ 注意事項

⚠️ 重要提示

• 運行 Docker 命令可能需要管理員權限，請確保以管理員身份執行相關操作。
• 請注意容器對 CPU 和內存的佔用，避免過度使用系統資源，影響系統性能。
• 確保處理所有可能的異常情況，如網絡中斷或鏡像未找到，以保證系統的穩定性。

🤝 貢獻指南

歡迎參與項目開發！請參考項目的貢獻指南以獲取更多信息。