K8s MCP Server

该项目是一个用于Kubernetes操作的模型控制协议（MCP）服务器。它提供了管理部署、Pod、服务等功能的工具。

预备条件

• Python 3.12或更高版本
• uv 包管理器
• Minikube（用于本地Kubernetes开发）
• Docker（可选，用于容器化部署）

运行MCP服务器

主要方法：直接运行

1. 创建虚拟环境：

   uv venv .venv
   

2. 激活虚拟环境：

   • 在macOS/Linux上：

     source .venv/bin/activate
     

   • 在Windows上：

     .venv\Scripts\activate
     

3. 安装依赖项：

   uv pip install -e .
   

4. 运行服务器：

   python src/main.py
   

备选方法：使用Docker（可选）

1. 拉取Docker镜像：

   docker pull chinnareddy578/k8s-mcp-server
   

2. 运行Docker容器：

   docker run -it \
     -v ${HOME}/.kube:/root/.kube:ro \
     -v ${HOME}/.minikube:/root/.minikube:ro \
     chinnareddy578/k8s-mcp-server
   

使用MCP服务器与MCP客户端

GitHub Copilot

1. 配置GitHub Copilot：

   • 打开你的GitHub Copilot设置。
   • 添加以下配置：

   {
       "servers": {
           "k8s-mcp-server": {
               "command": "python",
               "args": [
                   "src/main.py"
               ]
           }
       }
   }
   

   如果你更喜欢使用Docker：

   {
       "servers": {
           "k8s-mcp-server": {
               "command": "docker",
               "args": [
                   "run",
                   "-i",
                   "--rm",
                   "--init",
                   "-e", "PYTHONUNBUFFERED=1",
                   "-v", "${HOME}/.kube:/root/.kube:ro",
                   "-v", "${HOME}/.minikube:/root/.minikube:ro",
                   "chinnareddy578/k8s-mcp-server"
               ]
           }
       }
   }
   

2. 使用GitHub Copilot：

   • GitHub Copilot现在将使用MCP服务器进行代码建议和补全。

Claude Desktop

1. 配置Claude Desktop：

   • 打开Claude Desktop设置。
   • 添加以下配置：

   {
       "mcpServers": {
           "k8s-mcp-server": {
               "command": "python",
               "args": [
                   "src/main.py"
               ]
           }
       }
   }
   

   如果你更喜欢使用Docker：

   {
       "mcpServers": {
           "k8s-mcp-server": {
               "command": "docker",
               "args": [
                   "run",
                   "-i",
                   "--rm",
                   "--init",
                   "-e", "PYTHONUNBUFFERED=1",
                   "-v", "${HOME}/.kube:/root/.kube:ro",
                   "-v", "${HOME}/.minikube:/root/.minikube:ro",
                   "chinnareddy578/k8s-mcp-server"
               ]
           }
       }
   }
   

2. 使用Claude Desktop：

   • Claude Desktop现在将使用MCP服务器进行代码建议和补全。

故障排除

• Kubernetes配置： 确保Minikube正在运行并且你的kubeconfig已正确设置：

  minikube status
  minikube kubectl -- get pods
  

• 连接问题： 如果使用Docker，请确保容器正在运行并且可以访问你的Kubernetes配置：

  docker ps
  

• 未找到工具： 验证工具是否已在你的MCP服务器中注册，并且名称完全匹配。

许可

本项目采用MIT许可协议——详情见LICENSE文件。