Kubernetes MCP Server

# K8s MCP Server This project is a Model Control Protocol (MCP) server for Kubernetes operations. It provides tools for managing deployments, pods, services, and more. ## Prerequisites - Python 3.12 or higher - `uv` package manager - Minikube (for local Kubernetes development) - Docker (optional, for containerized deployment) ## Running the MCP Server ### Primary Method: Running Directly 1. **Create a virtual environment:** ```sh uv venv .venv ``` 2. **Activate the virtual environment:** - On macOS/Linux: ```sh source .venv/bin/activate ``` - On Windows: ```sh .venv\Scripts\activate ``` 3. **Install dependencies:** ```sh uv pip install -e . ``` 4. **Run the server:** ```sh python src/main.py ``` ### Alternative Method: Using Docker (Optional) 1. **Pull the Docker image:** ```sh docker pull chinnareddy578/k8s-mcp-server ``` 2. **Run the Docker container:** ```sh docker run -it \ -v ${HOME}/.kube:/root/.kube:ro \ -v ${HOME}/.minikube:/root/.minikube:ro \ chinnareddy578/k8s-mcp-server ``` ## Using the MCP Server with MCP Clients ### GitHub Copilot 1. **Configure GitHub Copilot:** - Open your GitHub Copilot settings. - Add the following configuration: ```json { "servers": { "k8s-mcp-server": { "command": "python", "args": [ "src/main.py" ] } } } ``` Alternatively, if you prefer using Docker: ```json { "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. **Use GitHub Copilot:** - GitHub Copilot will now use the MCP server for code suggestions and completions. ### Claude Desktop 1. **Configure Claude Desktop:** - Open Claude Desktop settings. - Add the following configuration: ```json { "mcpServers": { "k8s-mcp-server": { "command": "python", "args": [ "src/main.py" ] } } } ``` Alternatively, if you prefer using Docker: ```json { "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. **Use Claude Desktop:** - Claude Desktop will now use the MCP server for code suggestions and completions. ## Troubleshooting - **Kubernetes Configuration:** Make sure Minikube is running and your kubeconfig is properly set up: ```sh minikube status minikube kubectl -- get pods ``` - **Connection Issues:** If using Docker, ensure the container is running and has access to your Kubernetes configuration: ```sh docker ps ``` - **Tool Not Found:** Verify that the tool is registered in your MCP server and the name matches exactly. ## License This project is licensed under the MIT License - see the LICENSE file for details.