K8s MCP
A Kubernetes assistant powered by Model Context Protocol (MCP) and Google Gemini.
Requirements
- Python 3.10+
- Kubernetes cluster with kubeconfig configured
- Node.js 18+ (for frontend)
- Bun (optional, for faster frontend builds)
Quick Start
Use the Makefile to run different components:
1. MCP Server
Starts the MCP server that communicates with your Kubernetes cluster.
make mcp-server
Requires: Active Kubernetes cluster and configured kubeconfig.
2. CLI Mode
Interactive command-line interface to query your Kubernetes cluster.
make cli
3. Web Application (Backend + Frontend)
Start the backend API server:
make backend
Start the frontend in another terminal:
make frontend
Then open http://localhost:5173 in your browser.
4. All at Once
Start all services in background (development mode):
make dev
Project Structure
k8s_mcp_server.py - MCP server implementation
mcp_client.py - CLI client
app/
backend/ - FastAPI server
frontend/ - React UI
Configuration
Ensure your kubeconfig is at ~/.kube/config or set the KUBECONFIG environment variable.
The MCP server exposes 32 Kubernetes tools for managing resources, deployments, services, and more.
Features
- Real-time Kubernetes operations via MCP tools
- Chat interface with tool call results
- Inline tool call display in messages
- WebSocket streaming for live responses
- Automatic WebSocket reconnection
Make Commands
Available make targets (run make <target>):
make help— Show all available commandsmake mcp-server— Start the K8s MCP servermake cli— Launch the interactive CLI clientmake backend— Start the FastAPI backendmake frontend— Start the React frontendmake dev— Start backend and frontend in the background (development mode)make logs— Tail service logsmake stop— Stop all background servicesmake install-deps— Install project dependenciesmake clean— Remove build artifacts and cache files
Metadata
Release files for iflow-mcp_rahul007-bit-mcp-k8s 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_rahul007_bit_mcp_k8s-0.1.0.tar.gz | 12.3 kB | Without provenance | Details for iflow_mcp_rahul007_bit_mcp_k8s-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_rahul007_bit_mcp_k8s-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_rahul007_bit_mcp_k8s-0.1.0-py3-none-any.whl |
Total release size: 27.9 kB
Release files / iflow_mcp_rahul007_bit_mcp_k8s-0.1.0.tar.gz
| Download URL | iflow_mcp_rahul007_bit_mcp_k8s-0.1.0.tar.gz |
|---|---|
| Size | 12.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
761bfb4e192b55962389c08c96ee1a1218ec6d7594b8e9e5566f0a0add26bbff
|
|
BLAKE2b-256 checksum How to use checksums |
f392d35425d04df01cc1911c4fa4f8a7657578bb4cb9d05561955319d77ae9ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_rahul007_bit_mcp_k8s-0.1.0-py3-none-any.whl
| Download URL | iflow_mcp_rahul007_bit_mcp_k8s-0.1.0-py3-none-any.whl |
|---|---|
| Size | 15.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
40cfa048edadb4074a855553f0aa970f30803512cc1a35450ff166935f9920f5
|
|
BLAKE2b-256 checksum How to use checksums |
c7b1132848c39c99a8e583b94d611ace0da7daf886c0a69354c15d186f91bd6a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_rahul007-bit-mcp-k8s 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.