mcp-server-k8s

mcp-server-k8s

0
cloud_platformsos_automation

MCP-Server VBox is a tool for managing and operating Docker containers and Kubernetes clusters using the Model Context Protocol (MCP). It offers a unified interface for these operations through Claude Desktop, enhancing efficiency and integration.

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
  1. 构建项目
npm run build
  1. 配置 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 支持