Container MCP

🚀 容器化任務平臺文檔

這是一個容器化的任務執行平臺（MCP），能為用戶打造安全、隔離且可擴展的任務運行環境。平臺藉助 Docker 容器技術實現任務隔離與資源控制，還通過服務器發送事件（SSE）協議即時更新任務執行狀態。

🚀 快速開始

當 MCP 服務啟動後，可通過任何 MCP 客戶端連接到該服務。默認情況下，服務運行在 http://localhost:8000 或配置文件中指定的地址。

注意： 在配置 MCP 客戶端時，必須將目標地址設置為 http://127.0.0.1:<port>/sse（其中 <port> 為默認的 8000 端口或其他配置的端口）。路徑 /sse 是用於服務器發送事件通信所必需的。

✨ 主要特性

• 任務隔離：每個任務都在獨立的 Docker 容器中運行，確保任務之間互不影響。
• 資源限制：支持對 CPU、內存和磁盤空間進行硬性限制，防止資源濫用。
• 任務監控：提供即時的任務執行狀態更新，並允許用戶終止異常任務。
• 多租戶支持：通過配置可以實現不同用戶的資源隔離和權限控制。

📦 安裝指南

快速安裝

1. 克隆項目倉庫：

   git clone https://github.com/yourusername/container-mcp.git
   cd container-mcp
   

2. 下載並安裝 Docker：
   • 在 Linux 系統上，使用官方腳本安裝：

     curl -fsSL https://get.docker.com | bash -s docker
     

   • 在 Windows 或 macOS 上，訪問Docker 官網下載並安裝。
3. 啟動並加入 DockerGroupName 組（僅限 Linux）：

   sudo groupadd docker
   sudo usermod -aG docker $USER
   newgrp docker
   

4. 構建項目容器：

   ./bin/02-build-container.sh
   

5. 配置運行環境：

   ./bin/03-setup-environment.sh
   

6. 啟動 MCP 服務：

   ./bin/04-run-container.sh
   

詳細安裝步驟

1. 初始化項目：

   ./bin/01-init.sh
   

2. 構建容器鏡像：

   ./bin/02-build-container.sh
   

3. 配置運行環境：

   ./bin/03-setup-environment.sh
   

4. 啟動 MCP 服務：

   ./bin/04-run-container.sh
   

5. 運行測試（可選）：

   ./bin/05-run-tests.sh
   

💻 使用示例

基礎用法

from mcp.client.sse import sse_client
from mcp import ClientSession
import asyncio

async def main():
    # 連接到MCP服務
    sse_url = "http://127.0.0.1:8000/sse"  # 或其他配置的端口
    
    # 初始化SSE客戶端連接
    async with sse_client(sse_url) as client:
        # 創建MCP會話
        session = ClientSession(client)
        
        # 獲取任務執行狀態更新
        while True:
            update = await session.receive_update()
            print(f"接收到更新：{update}")

asyncio.run(main())

📚 詳細文檔

配置指南

MCP 支持通過環境變量進行配置，以下是常用配置項：

示例配置

在運行 MCP 服務前，可以通過設置環境變量來調整其行為：

# 啟用調試模式並指定鏡像倉庫
export MCP_DEBUG=true
export DOCKER_REGISTRY=private-registry:8080
./bin/04-run-container.sh

開發指南

環境準備

1. 安裝 Python 3.8 或更高版本：
   • 在 Linux 上使用包管理器安裝：

     sudo apt-get install python3 python3-pip
     

   • 在 Windows 和 macOS 上，訪問Python 官網下載並安裝。
2. 安裝項目依賴：

   pip install -r requirements.txt
   

代碼結構

項目的代碼主要包含以下幾個部分：

• container_mcp/: 包含容器化任務的核心實現。
• mcp_client/: 提供與 MCP 服務交互的客戶端接口。
• tasks/: 存放可執行的任務腳本或二進制文件。

開發流程

1. 克隆項目倉庫：

   git clone https://github.com/yourusername/container-mcp.git
   cd container-mcp
   

2. 安裝依賴：

   pip install -r requirements.txt
   

3. 啟動開發服務器：

   python -m mcp.start_development_server
   

📄 許可證

本項目遵循MIT 許可證，具體許可內容請參閱LICENSE.md文件。

作者信息

• 開發者：Your Name
• 聯繫郵箱：your.email@example.com
• GitHub 倉庫：Container-MCP

感謝您使用 Container-MCP！如需幫助或反饋問題，請隨時聯繫我們。