FastMCP on Kubernetes – PoC

🎯 Objectif

Déployer un serveur FastMCP (HTTP/SSE) sur Kubernetes avec :

• image Docker minimaliste,
• manifests K8s (Deployment/Service/Ingress/HPA),
• /healthz dédié sur 8090 (probes fiables),
• guide Minikube (Mac).

🧱 Arborescence

fastmcp-k8s/ ├─ Dockerfile ├─ server.py ├─ deployment.yaml ├─ service.yaml ├─ ingress.yaml ├─ hpa.yaml └─ README.md

Architecture (Vue simple)

Client (SSE/HTTP) | Ingress (TLS, timeouts SSE) | Service (ClusterIP :80 -> 8080) | Pods FastMCP (8080 = app SSE) └─ Health server (8090 = /healthz pour probes)

⚙️ Prérequis (Mac)

• Docker Desktop
• Homebrew, Minikube, kubectl

brew install minikube kubectl
minikube start --driver=docker --cpus=4 --memory=8192

## Build & Run Local
docker build -t fastmcp-demo:1.0.0 .
docker run -p 8080:8080 -p 8090:8090 fastmcp-demo:1.0.0
curl -i http://localhost:8090/healthz   # -> 200 OK + ok

## Déploiement K8s (Minikube)
kubectl create ns fastmcp
kubectl config set-context --current --namespace=fastmcp
kubectl apply -f deployment.yaml
kubectl apply -f service.yaml

##  Accès rapide :
curl -i http://localhost:8090/healthz