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

1. Clone the repository:

   hljs language-bash

   Copy

   git clone <repository-url>
   cd mcp-kubernetics
   

2. Install dependencies:

   hljs language-bash

   Copy

   npm install
   

3. Build the project:

   hljs language-bash

   Copy

   npm run build
   

   This will generate a build folder containing index.js.

Usage

Running with Claude AI

1. Open Claude desktop app.
2. Go to Settings.
3. Click on Developers.
4. Click on Edit Config.
5. This opens claude_desktop_config.json. Add the full path to the index.js file inside the args array as shown below.
6. Save the file.
7. 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