MCP Server Vbox

🚀 MCP-Server VBox 翻譯

MCP-Server VBox 是一個基於 Model Context Protocol (MCP) 的服務器實現，旨在管理和操作 Docker 容器與 Kubernetes 集群。它提供了統一接口，讓您能通過 Claude Desktop 輕鬆執行容器和 Pod 相關操作，提升管理效率。

✨ 主要特性

Docker 操作

• 列出所有容器（docker_list_containers）
• 拉取 Docker 鏡像（docker_pull_image）
• 創建新容器（docker_create_container）

Kubernetes 操作

• 列出指定命名空間的 Pod（k8s_list_pods）
• 創建 Deployment（k8s_create_deployment）
• 在 Pod 中執行命令（k8s_exec_pod）
• 進入 Pod 的交互式 shell（k8s_enter_pod）
• 退出 Pod 的執行環境（k8s_exit_pod）

執行環境管理

• 獲取當前執行環境（get_execution_context）
• 在當前環境執行命令（execute_command）
• 支持本地和 Pod 兩種執行環境
• 即時命令執行和輸出

📦 安裝指南

系統要求

• Node.js >= 14.0.0
• Docker
• Kubernetes 集群配置（~/.kube/config）
• Claude Desktop

安裝步驟

1. 安裝依賴

npm install

2. 構建項目

npm run build

3. 配置 Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json 中添加以下配置：

{
    "mcpServers": {
        "vbox": {
            "command": "node",
            "args": [
                "/path/to/your/vbox/build/index.js"
            ]
        }
    }
}

⚠️ 重要提示

請將 /path/to/your/vbox 替換為實際的項目路徑。

📚 詳細文檔

調試

如果需要調試，可以在 Claude Desktop 配置中添加調試選項：

{
    "mcpServers": {
        "vbox": {
            "command": "node",
            "args": [
                "--inspect",
                "/path/to/your/vbox/build/index.js"
            ],
            "debug": true
        }
    }
}

日誌文件位置：

• MCP 服務器日誌：~/Library/Logs/Claude/mcp-server-vbox.log
• Claude Desktop 日誌：~/Library/Logs/Claude/mcp.log

注意事項

1. 確保 Docker 守護進程正在運行
2. 確保有正確的 Kubernetes 配置文件（默認位置：~/.kube/config）
3. 確保有適當的集群訪問權限
4. 在使用 Pod 相關功能時，確保指定正確的命名空間和 Pod 名稱

📄 許可證

MIT License

👨‍💻 作者

[Your Name]

📝 更新日誌

1.0.0

• 初始版本發佈
• 實現基本的 Docker 和 Kubernetes 操作功能
• 添加交互式 shell 支持