k8s-dev-mcp

An MCP server that gives AI assistants access to Kubernetes enhancement proposals (KEPs), contributor guidelines, and official documentation.

What it does

Provides 7 tools over the Model Context Protocol:

Documents are sourced from three Kubernetes repos using sparse git checkouts:

• kubernetes/enhancements — KEPs

• kubernetes/community — contributor guidelines (API conventions, controller patterns, etc.)

• kubernetes/website — official docs (API concepts, CRDs, server-side apply, etc.)

Related MCP server: code-intel MCP Server

Requirements

• Node.js 18+

• Git

• ripgrep (rg) — optional, falls back to grep for full-text search

Install

Claude Code

claude mcp add k8s-dev-mcp npx github:Jefftree/k8s-dev-mcp

Gemini CLI

gemini mcp add k8s-dev-mcp npx github:Jefftree/k8s-dev-mcp

Manual

Add to your MCP client config:

{
  "mcpServers": {
    "k8s-dev-mcp": {
      "command": "npx",
      "args": ["github:Jefftree/k8s-dev-mcp"]
    }
  }
}

Configuration

Repos and documents are defined in the bundled config.yaml. Override it by setting:

export K8S_CONTEXT_CONFIG=/path/to/custom/config.yaml

Environment variables

Development

npm install
npm run build
npm start

License

Apache 2.0