kubinaut

belv2c/kubinaut

3.1

If you are the rightful owner of kubinaut and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server for Kubernetes that enables Cursor to interact with Kubernetes clusters through natural language.

kubinaut

A Model Context Protocol (MCP) server for Kubernetes that enables Cursor to interact with Kubernetes clusters through natural language.

Features

  • Natural language interaction with Kubernetes clusters
  • Real-time cluster state monitoring
  • Modern web UI for visualization
  • WebSocket-based MCP protocol implementation

Setup

  1. Install dependencies:
pip install -r requirements.txt
  1. Set up your Kubernetes configuration:
  • Make sure you have a valid kubeconfig file
  • The server will use your default Kubernetes context
  1. Start the server:
python -m src.main
  1. Access the UI: Open http://localhost:8000 in your browser

Project Structure

.
ā”œā”€ā”€ src/
│   ā”œā”€ā”€ main.py              # FastAPI application entry point
│   ā”œā”€ā”€ k8s/                 # Kubernetes client implementation
│   ā”œā”€ā”€ mcp/                 # MCP protocol implementation
│   └── api/                 # API routes
ā”œā”€ā”€ ui/                      # React frontend
ā”œā”€ā”€ requirements.txt         # Python dependencies
└── README.md               # This file

Development

  • Backend: FastAPI + Kubernetes Python Client
  • Frontend: React + TypeScript
  • Protocol: WebSocket-based MCP implementation