-
securityA
license-
qualityA read-only MCP server for Kubernetes that allows querying cluster information and diagnosing issues through natural language interfaces like Claude.
Last updated -
1
Python
MIT License
Integrations
Integrates with Google's Gemini API for AI capabilities, allowing the MCP server to leverage Gemini models for processing and responding to requests.
Enables interaction with Kubernetes clusters, allowing for management and orchestration of containerized applications through the Kubernetes API using the Python client.
kube-mcp
Get a Gemini APi Key
Goto https://aistudio.google.com/ and get yourself an API Key. Currently, gemini-2.0-pro-exp-02-05 LLM is available absolutely free of charge. Other models available for very cheap price also.
Install Codename Goose
Goose is an open source AI agent that supercharges your software development by automating coding tasks. We will use Codename Goose as it has a built in MCP client. Install Codename Goose by following the steps here https://block.github.io/goose/docs/getting-started/installation. Setup GOOGLE_API_KEY environment variable so that Goose knows to use Gemini API. Understand how to configure using goose configure and start as session using goose session.
Develop MCP Server
Read about MCP by reading the documentation : https://modelcontextprotocol.io/introduction and specifically the Python SDK : https://github.com/modelcontextprotocol/python-sdk
Clone this repository and test it using mcp dev server.py. Note that this project uses uv package manager instead of pip. Learn about uv by reading docs : https://github.com/astral-sh/uv
This project uses the kubernetes python client: https://github.com/kubernetes-client/python
Install Minikube
Install minikube by following isntructions : https://minikube.sigs.k8s.io/docs/start/?arch=/linux/x86-64/stable/binary+download
Ensure that the config to the cluster is provided to the MCP server. Look at the KubernetesManager and config.load_kube_config() to understand how the config is loaded.
Connect your MCP server to Codename Goose
Add the MCP Server as an extension by reading the following docs : https://block.github.io/goose/docs/getting-started/using-extensions
Start a new goose session using command goose session --with-builtin developer --with-extension "uvx kube-mcp"
Make it all work
Try giving a command in Goose and make it interact with Minikube using the MCP Server
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
An MCP server that enables interaction with Kubernetes/Minikube clusters through natural language, allowing AI agents like Codename Goose to manage Kubernetes resources via the Model Context Protocol.
Related MCP Servers
- -securityFlicense-qualityA server that enables LLMs to manage Kubernetes clusters through natural language commands, wrapping kubectl operations to provide a simplified interface for common Kubernetes tasks.Last updated -3Python
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.Last updated -32805TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to interact with Kubernetes clusters through natural language, supporting core Kubernetes operations, monitoring, security, and diagnostics.Last updated -417PythonMIT License