About Kopilot MCP
Kopilot MCP is an MCP client and server for operating Kubernetes resources through natural language. It lets users choose an LLM provider for kubectl-like commands.
Key features
- 01Operate Kubernetes resources in natural language
- 02Choose an LLM provider
- 03Run kubectl-like operations
Use cases
- 01List pods in a Kubernetes namespace
- 02Operate cluster resources with natural-language requests
MCP support
The project includes an MCP client and server. Starting the client automatically launches the server, which provides Kubernetes operations through MCP.
Details
From the project READMEKopilot MCP
A MCP remake 🔧 of my previous project.
Key Features
- Create an AI Kubernetes agent using MCP.
- Interact with Kubernetes resources using natural language.
- Customize LLM provider to perform "kubectl-like" commands.
- Learn how to use MCP to standardize tool calling.
Tech Stack
Getting Started
Prerequisites
- Python 3.12+
- uv
- A API key from LLM provider (e.g. OpenRouter)
- A Kubernetes cluster. (e.g. kind)
Setup
- Clone this repository.
- Configure
config/dev/example.tomland rename it toconfig/dev/config.toml. - Install dependencies.
uv sync
Run
- Run the MCP client. It will automatically start the MCP server.
uv run mcp_client.py
- Then you would see a prompt in the terminal:
Query (Type `exit`, `quit`, `q` to quit):
- Interact with natural language to operate Kubernetes resources. For example:
Query (Type `exit`, `quit`, `q` to quit): Get po in kube-system ns
- You would get the response similar like:
Here are the pods in the `kube-system` namespace:
- coredns-7db6d8ff4d-lz4s8
- coredns-7db6d8ff4d-qbgvc
- etcd-test-control-plane
- kindnet-cnjm6
- kube-apiserver-test-control-plane
- kube-controller-manager-test-control-plane
- kube-proxy-v647r
- kube-scheduler-test-control-plane
- sealed-secrets-controller-67767c668-dz4bj
Project Structure
kopilot-mcp
├── README.md # Project documentation
├── config # Configuration
│ ├── config.py
│ └── dev
│ └── example.toml
├── mcp_client.py # MCP client
├── mcp_server.py # MCP server
├── mcp_server_factory.py # MCP server factory
├── pyproject.toml # Python project meta
├── scheme # scheme (Kubernetes GVR ➡ GVK)
│ ├── __init__.py
│ └── scheme.py
├── utils # Utilities
│ ├── __init__.py
│ ├── clients.py
│ ├── helpers.py
│ └── models.py
└── uv.lock # uv lock file
Workflow

Contributing
- Fork the repository.
- Create your feature branch.
- Submit a pull request.
License
MIT License - See LICENSE file for details.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.