Kubernetics MCP Server
A Model Context Protocol (MCP) server that provides Kubernetes cluster introspection tools. It exposes various helper functions like listing pods, namespaces, node details, and more via MCP tools.
Ask AI about Kubernetics MCP Server
Powered by Claude · Grounded in docs
I know everything about Kubernetics MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
mcp-kubernetics
A Model Context Protocol (MCP) server that provides Kubernetes cluster introspection tools. It exposes various helper functions like listing pods, namespaces, node details, and more via MCP tools.
Features
- List all pods in all namespaces
- List pods by namespace
- List all namespaces
- Describe a specific pod
- Get sorted events from a namespace
- Get node resource usage (CPU, Memory)
- Get node taints and labels
Installation
-
Clone the repository:
git clone <repository-url> cd mcp-kubernetics -
Install dependencies:
npm install -
Build the project:
npm run buildThis will generate a
buildfolder containingindex.js.
Usage
Running with Claude AI
- Open Claude desktop app.
- Go to Settings.
- Click on Developers.
- Click on Edit Config.
- This opens
claude_desktop_config.json. Add the full path to theindex.jsfile inside theargsarray as shown below. - Save the file.
- Now you can ask questions related to your Kubernetes cluster like: "What are the pods in my cluster?"
Example claude_desktop_config.json snippet
Replace <FULL PATH OF BUILD> with the absolute path to your built index.js file.
{
"mcpServers": {
"kubernetics-mcp-server": {
"command": "node",
"args": ["<FULL PATH OF BUILD>/kubernetics-server/build/index.js"]
}
}
}
Available Tools
- get-kubernetics-namespaces: Returns a list of namespaces in the cluster.
- get-kubernetics-pods-detail-by-namespace: Returns pod details filtered by namespace.
- get-kubernetics-all-pods-detail: Returns all pod details from the cluster.
- describe-kubernetics-pod: Describe a specific pod by name and namespace.
- get-kubernetics-events: Get sorted events from a namespace.
- get-kubernetics-top-nodes: Get CPU and memory usage for nodes.
- get-kubernetics-node-details: Get Kubernetes node taints and labels.
Contributing
Contributions are welcome! Please open issues or pull requests.
License
MIT License
