# Install mcp-server-kubernetes with Homebrew

MCP Server for kubernetes management commands. Version 3.9.3 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:mcp-server-kubernetes
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mcp-server-kubernetes
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:mcp-server-kubernetes
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mcp-server-kubernetes>
- **Version:** 3.9.3
- **Source summary:** MCP Server for kubernetes management commands
- **Homepage:** <https://github.com/Flux159/mcp-server-kubernetes>
- **Repository:** <https://github.com/Flux159/mcp-server-kubernetes>
- **Upstream docs:** <https://github.com/Flux159/mcp-server-kubernetes#readme>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/mcp-server-kubernetes/-/mcp-server-kubernetes-3.9.3.tgz>
- **Last updated:** 2026-07-07T20:34:20Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- mcp-server-kubernetes (cli)
- mcp-server-kubernetes (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.9.3
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://github.com/Flux159/mcp-server-kubernetes
- info: No cached GitHub release or tag data was available.
## Project history and usage

mcp-server-kubernetes is an MCP server that exposes Kubernetes and Helm management operations to MCP clients. It wraps familiar cluster workflows such as get, describe, logs, apply, scale, rollout, port-forward, and Helm operations behind protocol tools.

### Project history

The repository was created in December 2024, during the first large wave of MCP servers that mapped existing command-line administration domains into agent-callable tools. Its README describes a server that connects to a Kubernetes cluster and loads kubeconfig from multiple sources.

The project expanded beyond basic kubectl commands into advanced operations, prompts, observability, secrets masking, and safety modes. The advanced README documents authentication priority order, custom kubeconfig paths, environment-based cluster credentials, read-only mode, and non-destructive mode.

### Adoption history

The server is packaged for use through `npx mcp-server-kubernetes`, Homebrew, and client-specific integrations such as Claude Code, Claude Desktop, VS Code, Cursor, Gemini CLI extensions, and mcpb packages. This broad installation documentation reflects the package's role as infrastructure glue rather than a single-client demo.

GitHub metadata showed more than a thousand stars and hundreds of forks by July 2026, and release metadata showed continued 3.x releases in 2026. The project also links to ecosystem badges and MCP catalog listings, reinforcing that it is a packaged server intended for discovery and reuse.

### How it is used

Users must have `kubectl`, a valid kubeconfig, cluster access, and optionally Helm v3 in PATH. By default, the server loads credentials from `~/.kube/config`, while advanced options allow full kubeconfig YAML or JSON, server/token environment variables, in-cluster config, `KUBECONFIG_PATH`, or the standard `KUBECONFIG` variable.

Typical client usage is a stdio command such as `npx mcp-server-kubernetes`. Operators can enable read-only or non-destructive modes through environment variables when connecting production or shared clusters.

### Why package nerds care

mcp-server-kubernetes is notable because it packages a high-stakes existing CLI domain rather than a toy MCP demo. The value for package users is in reusing the local Kubernetes credential model and command-line tools while exposing them through MCP.

It also illustrates why package metadata matters for MCP servers: a cluster-management server needs clear docs around credentials, safety modes, dependencies, and client configuration so users understand what a one-line `npx` or Homebrew install is allowed to do.

### Timeline

- 2024: GitHub repository created for Flux159/mcp-server-kubernetes.
- 2025: README documents kubectl, Helm, client configuration, and advanced cluster operations.
- 2025: Advanced README documents authentication priority order and safety modes.
- 2026: 3.x releases continue, including v3.9.2 in June 2026.

### Related projects

- Kubernetes and kubectl provide the underlying cluster-management model.
- Helm is used for optional chart operations.
- Flux159/mcp-chat is documented as a CLI chat client that can interact with the server.

### Sources

- <https://api.github.com/repos/Flux159/mcp-server-kubernetes>
- <https://api.github.com/repos/Flux159/mcp-server-kubernetes/releases>
- <https://github.com/Flux159/mcp-server-kubernetes>
- <https://github.com/Flux159/mcp-server-kubernetes#readme>
- <https://github.com/Flux159/mcp-server-kubernetes/blob/main/ADVANCED_README.md>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.kube/config

## Credential files

- Unix: ~/.kube/config
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mcp-server-kubernetes
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [chaoskube](https://www.automicvault.com/pkg/brew/chaoskube/) - Shares av.db curated category or tags: cli, cloud-infrastructure, helm, kubernetes.
- [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes.
- [cozyhr](https://www.automicvault.com/pkg/brew/cozyhr/) - Shares av.db curated category or tags: cli, cloud-infrastructure, helm, kubernetes.
- [cyphernetes](https://www.automicvault.com/pkg/brew/cyphernetes/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubectl, kubernetes.
- [fleet-cli](https://www.automicvault.com/pkg/brew/fleet-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, helm, kubernetes.
- [havener](https://www.automicvault.com/pkg/brew/havener/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubectl, kubernetes.
- [helmfile](https://www.automicvault.com/pkg/brew/helmfile/) - Shares av.db curated category or tags: cli, cloud-infrastructure, helm, kubernetes.
- [helmify](https://www.automicvault.com/pkg/brew/helmify/) - Shares av.db curated category or tags: cli, cloud-infrastructure, helm, kubernetes.
- [mcp-server-kubernetes](https://www.automicvault.com/pkg/npm/mcp-server-kubernetes/) - Same normalized package name appears in another local ecosystem. Shared terms: kubectl, kubernetes, mcp, mcp-server-kubernetes, node.
- [mcp-grafana](https://www.automicvault.com/pkg/brew/mcp-grafana/) - Package names and metadata indicate a similar tool family. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, mcp.
- [mcp-server-kubernetes](https://www.automicvault.com/pkg/npm/mcp-server-kubernetes/) - Same normalized package name in another local ecosystem.

## Combined YAML source

View the package source record on GitHub. [combined/mcp-server-kubernetes.yml](https://github.com/automic-vault/db/blob/main/combined/mcp-server-kubernetes.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
