MCP Collection

🚀 MCP‑Collection

MCP‑Collection 是一個 Docker 鏡像，它將多個 Model‑Context‑Protocol (MCP) 服務器打包在一起，並通過統一入口點對外提供服務，方便用戶使用和管理。

🚀 快速開始

拉取鏡像

# 拉取多架構鏡像
docker pull ghcr.io/erhardtconsulting/mcp‑collection:1.0.0

列出可用服務器

# 列出可用的 MCP 服務器（顯示幫助信息）
docker run --rm ghcr.io/erhardtconsulting/mcp‑collection

運行特定服務器

# 運行 Git 服務器，並通過額外參數傳遞給底層 CLI
docker run --rm -p 8080:8080 \
  ghcr.io/erhardtconsulting/mcp‑collection mcp-server-fetch --test

包含的 MCP 服務器

✨ 主要特性

• 一個鏡像 – 多個服務器：運行時通過一個參數選擇所需的 MCP 服務器。
• 遠程就緒，開箱即用：內置的 supergateway 將服務器的 stdio 接口橋接到 HTTP/SSE 或 WebSocket。
• Kubernetes 首先考量：內置健康端點、非 root 用戶和極小的 distroless 運行時層（≤80MB）。
• 確定性構建：使用 uv.lock 鎖定 Python 依賴，不允許運行時安裝或允許。

🐳 鏡像佈局

/mcp-collection
├── root
     ├── docker-entrypoint.sh # 選擇並驗證服務器，啟動 supergateway
     ├── .venv/              # 所有 MCP 服務器的隔離 Python 環境
     ├── node_modules/       # 所有 MCP 服務器的隔離 Node 環境
     ├── pyproject.toml      # Python MCP 服務器依賴列表
     └── package.json        # Node MCP 服務器依賴列表

入口點執行以下步驟：

1. 激活虛擬環境（.venv）。
2. 閱讀一個固定白名單 (ALLOWED_SERVERS)。
3. 驗證用戶提供的服務器名稱。
4. 執行 supergateway --stdio "<server> [額外參數]"。

☸️ Kubernetes 部署示例

apiVersion: apps/v1
kind: Deployment
metadata:
  name: mcp-collection
spec:
  selector:
    matchLabels: {app: mcp-collection}
  template:
    metadata:
      labels: {app: mcp-collection}
    spec:
      containers:
      - name: mcp
        image: ghcr.io/erhardtconsulting/mcp-collection:1.0.0
        args: ["mcp-server-kubernetes"]
        ports:
        - containerPort: 8080

⚠️ 安全注意事項

• 鏡像默認以非 root 用戶運行。
• 不允許 shell 訪問，確保容器安全。

📋 貢獻指南

• 歡迎 fork 和 pull request！
• 提交前，請閱讀 CONTRIBUTING.md。