{"id":26570787,"url":"https://github.com/manusa/kubernetes-mcp-server","last_synced_at":"2025-04-12T08:39:11.343Z","repository":{"id":276918241,"uuid":"930678258","full_name":"manusa/kubernetes-mcp-server","owner":"manusa","description":"Model Context Protocol (MCP) server for Kubernetes and OpenShift","archived":false,"fork":false,"pushed_at":"2025-04-07T07:07:02.000Z","size":647,"stargazers_count":67,"open_issues_count":5,"forks_count":16,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-07T08:23:04.033Z","etag":null,"topics":["containers","context","kubernetes","mcp","model","model-context-pr","openshift","protocol"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manusa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-11T02:57:36.000Z","updated_at":"2025-04-07T07:05:59.000Z","dependencies_parsed_at":"2025-02-26T06:22:10.793Z","dependency_job_id":"b97eee1f-486f-4977-b568-7b13968ab500","html_url":"https://github.com/manusa/kubernetes-mcp-server","commit_stats":null,"previous_names":["manusa/kubernetes-mcp-server"],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manusa%2Fkubernetes-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manusa%2Fkubernetes-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manusa%2Fkubernetes-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manusa%2Fkubernetes-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manusa","download_url":"https://codeload.github.com/manusa/kubernetes-mcp-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248542903,"owners_count":21121826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["containers","context","kubernetes","mcp","model","model-context-pr","openshift","protocol"],"created_at":"2025-03-22T22:19:14.501Z","updated_at":"2025-04-12T08:39:11.336Z","avatar_url":"https://github.com/manusa.png","language":"Go","funding_links":[],"categories":["Cloud Infrastructure","Cloud \u0026 DevOps MCP Servers","MCP 服务器精选列表","Container Orchestration","Community Servers","Legend","⚙️ DevOps","サーバー実装","Task and Project Management","MCP Servers","Cloud Platforms","Table of Contents","🐳 Kubernetes \u0026 Containers","🗂️ Extensions by Category","Uncategorized"],"sub_categories":["🐳 Container Orchestration","☁️ 云平台与服务集成 (AWS, Cloudflare, Azure, K8s, etc.)","☁️ \u003ca name=\"cloud-platforms\"\u003e\u003c/a\u003eCloud Platforms","☁️ \u003ca name=\"cloud-platforms\"\u003e\u003c/a\u003eクラウドプラットフォーム","☁️ Cloud Platforms","How to Submit","☁️ Cloud Platforms \u0026 Infrastructure","Cloud Platforms","Cloud \u0026 DevOps","⚙️ Development Tools","Uncategorized"],"readme":"# Kubernetes MCP Server\n\n[![GitHub License](https://img.shields.io/github/license/manusa/kubernetes-mcp-server)](https://github.com/manusa/kubernetes-mcp-server/blob/main/LICENSE)\n[![npm](https://img.shields.io/npm/v/kubernetes-mcp-server)](https://www.npmjs.com/package/kubernetes-mcp-server)\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/manusa/kubernetes-mcp-server?sort=semver)](https://github.com/manusa/kubernetes-mcp-server/releases/latest)\n[![Build](https://github.com/manusa/kubernetes-mcp-server/actions/workflows/build.yaml/badge.svg)](https://github.com/manusa/kubernetes-mcp-server/actions/workflows/build.yaml)\n\n[✨ Features](#features) | [🚀 Getting Started](#getting-started) | [🎥 Demos](#demos) | [⚙️ Configuration](#configuration) | [🧑‍💻 Development](#development)\n\nhttps://github.com/user-attachments/assets/be2b67b3-fc1c-4d11-ae46-93deba8ed98e\n\n## ✨ Features \u003ca id=\"features\"\u003e\u003c/a\u003e\n\nA powerful and flexible Kubernetes [Model Context Protocol (MCP)](https://blog.marcnuri.com/model-context-protocol-mcp-introduction) server implementation with support for **Kubernetes** and **OpenShift**.\n\n- **✅ Configuration**:\n  - Automatically detect changes in the Kubernetes configuration and update the MCP server.\n  - **View** and manage the current [Kubernetes `.kube/config`](https://blog.marcnuri.com/where-is-my-default-kubeconfig-file) or in-cluster configuration.\n- **✅ Generic Kubernetes Resources**: Perform operations on **any** Kubernetes or OpenShift resource.\n  - Any CRUD operation (Create or Update, Get, List, Delete).\n- **✅ Pods**: Perform Pod-specific operations.\n  - **List** pods in all namespaces or in a specific namespace.\n  - **Get** a pod by name from the specified namespace.\n  - **Delete** a pod by name from the specified namespace.\n  - **Show logs** for a pod by name from the specified namespace.\n  - **Exec** into a pod and run a command.\n  - **Run** a container image in a pod and optionally expose it.\n- **✅ Namespaces**: List Kubernetes Namespaces.\n- **✅ Events**: View Kubernetes events in all namespaces or in a specific namespace.\n- **✅ Projects**: List OpenShift Projects.\n\nUnlike other Kubernetes MCP server implementations, this **IS NOT** just a wrapper around `kubectl` or `helm` command-line tools.\n\nThere is **NO NEED** for external dependencies or tools to be installed on the system.\nIf you're using the native binaries you don't even need to have Node or Python installed on your system.\n\n## 🚀 Getting Started \u003ca id=\"getting-started\"\u003e\u003c/a\u003e\n\n### Requirements\n\n- Access to a Kubernetes cluster.\n\n### Claude Desktop\n\n#### Using npx\n\nIf you have npm installed, this is the fastest way to get started with `kubernetes-mcp-server` on Claude Desktop.\n\nOpen your `claude_desktop_config.json` and add the mcp server to the list of `mcpServers`:\n``` json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"kubernetes-mcp-server@latest\"\n      ]\n    }\n  }\n}\n```\n\n### VS Code / VS Code Insiders\n\nInstall the Kubernetes MCP server extension in VS Code Insiders by pressing the following link:\n\n[\u003cimg alt=\"Install in VS Code Insiders\" src=\"https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square\u0026label=Install%20Server\u0026color=24bfa5\"\u003e](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522kubernetes%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522kubernetes-mcp-server%2540latest%2522%255D%257D)\n\nAlternatively, you can install the extension manually by running the following command:\n\n```shell\n# For VS Code\ncode --add-mcp '{\"name\":\"kubernetes\",\"command\":\"npx\",\"args\":[\"kubernetes-mcp-server@latest\"]}'\n# For VS Code Insiders\ncode-insiders --add-mcp '{\"name\":\"kubernetes\",\"command\":\"npx\",\"args\":[\"kubernetes-mcp-server@latest\"]}'\n```\n\n### Goose CLI\n\n[Goose CLI](https://blog.marcnuri.com/goose-on-machine-ai-agent-cli-introduction) is the easiest (and cheapest) way to get rolling with artificial intelligence (AI) agents.\n\n#### Using npm\n\nIf you have npm installed, this is the fastest way to get started with `kubernetes-mcp-server`.\n\nOpen your goose `config.yaml` and add the mcp server to the list of `mcpServers`:\n```yaml\nextensions:\n  kubernetes:\n    command: npx\n    args:\n      - -y\n      - kubernetes-mcp-server@latest\n\n```\n\n## 🎥 Demos \u003ca id=\"demos\"\u003e\u003c/a\u003e\n\n### Diagnosing and automatically fixing an OpenShift Deployment\n\nDemo showcasing how Kubernetes MCP server is leveraged by Claude Desktop to automatically diagnose and fix a deployment in OpenShift without any user assistance.\n\nhttps://github.com/user-attachments/assets/a576176d-a142-4c19-b9aa-a83dc4b8d941\n\n### _Vibe Coding_ a simple game and deploying it to OpenShift\n\nIn this demo, I walk you through the process of _Vibe Coding_ a simple game using VS Code and how to leverage [Podman MCP server](https://github.com/manusa/podman-mcp-server) and Kubernetes MCP server to deploy it to OpenShift.\n\n\u003ca href=\"https://www.youtube.com/watch?v=l05jQDSrzVI\" target=\"_blank\"\u003e\n \u003cimg src=\"docs/images/vibe-coding.jpg\" alt=\"Vibe Coding: Build \u0026 Deploy a Game on Kubernetes\" width=\"240\"  /\u003e\n\u003c/a\u003e\n\n## ⚙️ Configuration \u003ca id=\"configuration\"\u003e\u003c/a\u003e\n\nThe Kubernetes MCP server can be configured using command line (CLI) arguments.\n\nYou can run the CLI executable either by using `npx` or by downloading the [latest release binary](https://github.com/manusa/kubernetes-mcp-server/releases/latest).\n\n```shell\n# Run the Kubernetes MCP server using npx (in case you have npm installed)\nnpx kubernetes-mcp-server@latest --help\n```\n\n```shell\n# Run the Kubernetes MCP server using the latest release binary\n./kubernetes-mcp-server --help\n```\n\n### Configuration Options\n\n| Option        | Description                                                                                                                                                                                                                                                                                   |\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `--sse-port`  | Starts the MCP server in Server-Sent Event (SSE) mode and listens on the specified port.                                                                                                                                                                                                      |\n| `--log-level` | Sets the logging level (values [from 0-9](https://github.com/kubernetes/community/blob/master/contributors/devel/sig-instrumentation/logging.md)). Similar to [kubectl logging levels](https://kubernetes.io/docs/reference/kubectl/quick-reference/#kubectl-output-verbosity-and-debugging). |\n\n## 🧑‍💻 Development \u003ca id=\"development\"\u003e\u003c/a\u003e\n\n### Running with mcp-inspector\n\nCompile the project and run the Kubernetes MCP server with [mcp-inspector](https://modelcontextprotocol.io/docs/tools/inspector) to inspect the MCP server.\n\n```shell\n# Compile the project\nmake build\n# Run the Kubernetes MCP server with mcp-inspector\nnpx @modelcontextprotocol/inspector@latest $(pwd)/kubernetes-mcp-server\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanusa%2Fkubernetes-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanusa%2Fkubernetes-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanusa%2Fkubernetes-mcp-server/lists"}