MCP server
Kubernetes MCP server
Live Kubernetes network traffic: HTTP, gRPC, Redis, Kafka and DNS calls between services.
★ 12kpushed 2026-10-21Apache-2.0
No one-line setup: it needs a build step, an app plugin or account details. Follow the README.
Native Go server for Kubernetes and OpenShift: pods, resources, logs, Helm; no kubectl needed.
★ 2.2kpushed 2026-10-23Apache-2.0
Run in a terminal. Everything after -- is the command that starts the server. docs
claude mcp add --transport stdio kubernetes -- npx -y kubernetes-mcp-server
Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubernetes-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubernetes-mcp-server"
]
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"kubernetes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kubernetes-mcp-server"
]
}
}
}Run codex mcp add kubernetes -- npx -y kubernetes-mcp-server, or add this to ~/.codex/config.toml. docs
[mcp_servers.kubernetes] command = "npx" args = ["-y", "kubernetes-mcp-server"]
Run in a terminal (-s user adds it for all projects; the default is this project). docs
gemini mcp add -s user kubernetes npx -- -y kubernetes-mcp-server
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add kubernetes -- npx -y kubernetes-mcp-server
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubernetes-mcp-server"
]
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubernetes-mcp-server"
]
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kubernetes": {
"type": "local",
"command": [
"npx",
"-y",
"kubernetes-mcp-server"
],
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubernetes-mcp-server"
]
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": [
"-y",
"kubernetes-mcp-server"
]
}
}
}kubectl and Helm operations with a non-destructive mode.
★ 1.6kpushed 2026-10-21MIT
Run in a terminal. Everything after -- is the command that starts the server. docs
claude mcp add --transport stdio kubernetes-flux159 -- npx -y mcp-server-kubernetes
Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs
{
"mcpServers": {
"kubernetes-flux159": {
"command": "npx",
"args": [
"-y",
"mcp-server-kubernetes"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"kubernetes-flux159": {
"command": "npx",
"args": [
"-y",
"mcp-server-kubernetes"
]
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"kubernetes-flux159": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-server-kubernetes"
]
}
}
}Run codex mcp add kubernetes-flux159 -- npx -y mcp-server-kubernetes, or add this to ~/.codex/config.toml. docs
[mcp_servers.kubernetes-flux159] command = "npx" args = ["-y", "mcp-server-kubernetes"]
Run in a terminal (-s user adds it for all projects; the default is this project). docs
gemini mcp add -s user kubernetes-flux159 npx -- -y mcp-server-kubernetes
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add kubernetes-flux159 -- npx -y mcp-server-kubernetes
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"kubernetes-flux159": {
"command": "npx",
"args": [
"-y",
"mcp-server-kubernetes"
]
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"kubernetes-flux159": {
"command": "npx",
"args": [
"-y",
"mcp-server-kubernetes"
]
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kubernetes-flux159": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-server-kubernetes"
],
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"kubernetes-flux159": {
"command": "npx",
"args": [
"-y",
"mcp-server-kubernetes"
]
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"kubernetes-flux159": {
"command": "npx",
"args": [
"-y",
"mcp-server-kubernetes"
]
}
}
}Which one to pick
- Start with Kubeshark: it's maintained by Kubeshark and follows its API.
- A local server (Kubernetes (Red Hat) and Kubernetes (Flux159)) runs on your machine with an API key or token, and works offline from the vendor's hosting.
FAQ
Is there an official Kubernetes MCP server?+
Yes: Kubeshark, maintained by Kubeshark. There are also 2 community servers: Kubernetes (Red Hat) and Kubernetes (Flux159).
How do I connect Kubernetes to Claude?+
In Claude Code, run the claude mcp add command shown above. In Claude Desktop, add the server to claude_desktop_config.json (Settings > Developer > Edit Config) and restart the app.
How do I use the Kubernetes MCP server in Cursor or VS Code?+
Open the Cursor or VS Code tab on the server above: it has the exact mcp.json entry. The same server also works in Claude Code, Claude Desktop / claude.ai, ChatGPT, Cursor, VS Code and Codex.
Is it safe to give an AI agent access to Kubernetes?+
Start with the official server, a read-only or test account and approval prompts on for anything that writes. Content the agent reads from Kubernetes (tickets, messages, pages) can carry prompt-injection instructions, so don't auto-approve actions.
All cloud & devops MCP servers · Agent skills · How MCP setup works in each client
MCP servers for similar apps: Airflow · Amazon ECS · Amazon EKS · Ansible · Argo CD · Artifactory · AWS CDK · AWS Lambda · Azure Key Vault · Azure Monitor · Azure Storage · Buildkite · CircleCI · Cloud Run · Cloudflare · Cloudflare Workers · Compute Engine · Cosmos DB · DigitalOcean · Docker Hub · DynamoDB · Fly.io · GKE · Google Cloud