Metadata-Version: 2.4
Name: iflow-mcp_rahul007-bit-mcp-k8s
Version: 0.1.0
Summary: Kubernetes assistant powered by Model Context Protocol (MCP)
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.13.1
Requires-Dist: fastapi>=0.119.1
Requires-Dist: fastmcp>=2.12.4
Requires-Dist: google-genai>=1.45.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: kubernetes>=34.1.0
Requires-Dist: mcp[cli]>=1.18.0
Requires-Dist: ollama>=0.6.0
Requires-Dist: pydantic>=2.12.3
Requires-Dist: python-dotenv>=1.1.1
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: together>=1.5.27
Requires-Dist: uvicorn>=0.38.0
Requires-Dist: websockets>=15.0.1

# 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.

```bash
make mcp-server
```

Requires: Active Kubernetes cluster and configured kubeconfig.

### 2. CLI Mode

Interactive command-line interface to query your Kubernetes cluster.

```bash
make cli
```

### 3. Web Application (Backend + Frontend)

Start the backend API server:

```bash
make backend
```

Start the frontend in another terminal:

```bash
make frontend
```

Then open http://localhost:5173 in your browser.

### 4. All at Once

Start all services in background (development mode):

```bash
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 commands  
- `make mcp-server` — Start the K8s MCP server  
- `make cli` — Launch the interactive CLI client  
- `make backend` — Start the FastAPI backend  
- `make frontend` — Start the React frontend  
- `make dev` — Start backend and frontend in the background (development mode)  
- `make logs` — Tail service logs  
- `make stop` — Stop all background services  
- `make install-deps` — Install project dependencies  
- `make clean` — Remove build artifacts and cache files
