How do I install Kubeview?

Kubeview is a local plugin. Install it using npm package: kubeview-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Kubeview need?

Kubeview requires the following credentials or environment variables: KUBECONFIG, MCP_MODE, MCP_LOG_LEVEL, MCP_KUBE_CONTEXT, MCP_K8S_SKIP_TLS_VERIFY, MCP_HIDE_SENSITIVE, MCP_TIMEOUT, MCP_DISABLE_KUBERNETES_PLUGIN, MCP_DISABLE_HELM_PLUGIN, MCP_DISABLE_ARGO_PLUGIN, MCP_DISABLE_ARGOCD_PLUGIN. You can find setup instructions on the server detail page.

What AI apps work with Kubeview?

Kubeview uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Kubeview MCP Server

by Mikhae1

Developer ToolsLow Risk9.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

Read-only Model Context Protocol MCP server enabling code-driven AI analysis of Kubernetes clusters.

About

Read-only Model Context Protocol MCP server enabling code-driven AI analysis of Kubernetes clusters.

Security Report

9.0

Low Risk9.0Low Risk

Valid MCP server (3 strong, 4 medium validity signals). 1 known CVE in dependencies (0 critical, 1 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

5 files analyzed · 2 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Path to kubeconfig file; defaults to ~/.kube/config if unset.Optional

Environment variable: KUBECONFIG

Server mode: 'all' (default), 'code', or 'tools'. Controls which features are enabled.Optional

Environment variable: MCP_MODE

Logging level: 'error', 'warn', 'info' (default), or 'debug'.Optional

Environment variable: MCP_LOG_LEVEL

Kubernetes context name to use. If unset, uses the current context from kubeconfig.Optional

Environment variable: MCP_KUBE_CONTEXT

Skip TLS certificate verification for Kubernetes API (use 'true' or '1'). Not recommended for production.Optional

Environment variable: MCP_K8S_SKIP_TLS_VERIFY

Enable global sensitive data masking. Set to 'true' or '1' to mask sensitive values in responses.Optional

Environment variable: MCP_HIDE_SENSITIVE

Default timeout in milliseconds for operations. If unset, uses plugin-specific defaults.Optional

Environment variable: MCP_TIMEOUT

Disable Kubernetes plugin. Set to 'true' or '1' to disable.Optional

Environment variable: MCP_DISABLE_KUBERNETES_PLUGIN

Disable Helm plugin. Set to 'true' or '1' to disable.Optional

Environment variable: MCP_DISABLE_HELM_PLUGIN

Disable Argo Workflows plugin. Set to 'true' or '1' to disable.Optional

Environment variable: MCP_DISABLE_ARGO_PLUGIN

Disable Argo CD plugin. Set to 'true' or '1' to disable.Optional

Environment variable: MCP_DISABLE_ARGOCD_PLUGIN

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-mikhae1-kubeview": {
      "env": {
        "MCP_MODE": "your-mcp-mode-here",
        "KUBECONFIG": "your-kubeconfig-here",
        "MCP_TIMEOUT": "your-mcp-timeout-here",
        "MCP_LOG_LEVEL": "your-mcp-log-level-here",
        "MCP_KUBE_CONTEXT": "your-mcp-kube-context-here",
        "MCP_HIDE_SENSITIVE": "your-mcp-hide-sensitive-here",
        "MCP_DISABLE_ARGO_PLUGIN": "your-mcp-disable-argo-plugin-here",
        "MCP_DISABLE_HELM_PLUGIN": "your-mcp-disable-helm-plugin-here",
        "MCP_K8S_SKIP_TLS_VERIFY": "your-mcp-k8s-skip-tls-verify-here",
        "MCP_DISABLE_ARGOCD_PLUGIN": "your-mcp-disable-argocd-plugin-here",
        "MCP_DISABLE_KUBERNETES_PLUGIN": "your-mcp-disable-kubernetes-plugin-here"
      },
      "args": [
        "-y",
        "kubeview-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

KubeView MCP – Kubernetes Model Context Protocol Server

KubeView is a read-only Model Context Protocol (MCP) server that lets AI agents (Cursor, Claude Code, Codex CLI, Gemini CLI, etc.) safely inspect, diagnose, and debug Kubernetes clusters. It covers Kubernetes core, Helm, Argo Workflows, and Argo CD.

Read more: Evicting MCP tool calls from your Kubernetes cluster

✨ Features

🧠 Code Mode – Sandboxed TypeScript runtime for complex reasoning and multi-step workflows.
🛡️ Read-Only & Safe – Zero write access; sensitive data masking for production clusters.
☸️ Kubernetes – List/get resources, fetch metrics, stream logs and events, exec into containers, diagnose network issues.
📦 Helm (API-first) – Inspect releases, values, manifests, and history via the Kubernetes API with CLI fallback.
🐙 Argo Ecosystem – Manage Argo Workflows and Argo CD via the Kubernetes API or CLI.

🚀 Quick Start

Prerequisites

Node.js ≥ 18
Access to a Kubernetes cluster
Optional CLIs in $PATH: helm (fallback only), argo, argocd

Installation

# Run the server directly
npx -y kubeview-mcp

# Add to Claude Code
claude mcp add kubernetes -- npx kubeview-mcp

MCP Client Configuration

Add to your mcpServers config (Cursor, Claude Desktop, etc.):

{
  "mcpServers": {
    "kubeview": {
      "command": "npx",
      "args": ["-y", "kubeview-mcp"]
    }
  }
}

Environment Variables

Variable	Description	Default
`KUBECONFIG`	Path to kubeconfig file	`~/.kube/config`
`MCP_MODE`	Server mode: `all`, `code`, or `tools`	`all`
`MCP_LOG_LEVEL`	Log level: `error`, `warn`, `info`, `debug`	`info`
`MCP_HIDE_SENSITIVE`	Mask sensitive data globally	`false`

🛠️ Tools

Kubernetes

Tool	Description
`kube_list`	List resources or get cluster diagnostics
`kube_get`	Describe a specific resource (all K8s types supported)
`kube_metrics`	Fetch CPU/memory metrics for nodes and pods
`kube_logs`	Fetch or stream container logs
`kube_exec`	Execute commands inside containers
`kube_port`	Port-forward to pods or services
`kube_net`	Run in-cluster network diagnostics

Helm

Tool	Description
`helm_list`	List Helm releases (Kubernetes API first, CLI fallback)
`helm_get`	Fetch release values, manifests, notes, hooks, status, history

Helm execution strategy: Tools read Helm metadata directly from Kubernetes storage (Secrets / ConfigMaps) by default — no helm binary needed for standard read-only use. CLI fallback is used for non-JSON formatting or non-Kubernetes storage backends (e.g. SQL).

Argo

Tool	Description
`argo_list`	List Argo Workflows
`argo_get`	Inspect a specific Argo Workflow
`argocd_app`	Inspect Argo CD applications

Utilities

Tool	Description
`run_code`	Execute sandboxed TypeScript for complex tasks
`plan_step`	Persist step-by-step planning state across long investigations

Why plan_step? It keeps the chat context clean by storing progress externally, gives agents a structured state machine (plan → execute → verify → branch), and encourages the think-then-act rhythm that produces better results on complex workflows.

🧠 Code Mode

Inspired by Code execution with MCP, KubeView ships a sandboxed code runtime for agents to explore the API and run complex workflows.

MCP Bridge – All registered MCP tools are callable from within run_code.
Dynamic TypeScript Definitions – Tool schemas are auto-converted to a typed global.d.ts, preventing hallucinated parameters.
Tool Discovery – tools.search() and tools.list() let agents find capabilities at runtime without loading the full schema.
Sandboxed Execution – Locked-down Node.js vm environment with access only to console and the tools global.

Enable code-only mode:

"env": { "MCP_MODE": "code" }

Built-in `code-mode` Prompt

The server includes a code-mode MCP prompt that injects full TypeScript API docs and examples into the agent context. In Cursor, type /kubeview/code-mode in the prompt bar to activate it.

💻 Local Development

# Clone and install
git clone https://github.com/mikhae1/kubeview-mcp.git
cd kubeview-mcp
npm install

# Build and run
npm run build
npm start

# Test
npm test

# Run a tool directly via CLI
npm run command -- kube_list --namespace=default

📄 License

MIT © mikhae1

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.

Kubeview MCP Server

About

Security Report

Findings (2)Action required

Permissions Required

What You'll Need

How to Install

Documentation

KubeView MCP – Kubernetes Model Context Protocol Server

✨ Features

🚀 Quick Start

Prerequisites

Installation

MCP Client Configuration

Environment Variables

🛠️ Tools

Kubernetes

Helm

Argo

Utilities

🧠 Code Mode

Built-in code-mode Prompt

💻 Local Development

📄 License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent

Kubeview MCP Server

About

Security Report

Findings (2)Action required

Permissions Required

What You'll Need

How to Install

Documentation

KubeView MCP – Kubernetes Model Context Protocol Server

✨ Features

🚀 Quick Start

Prerequisites

Installation

MCP Client Configuration

Environment Variables

🛠️ Tools

Kubernetes

Helm

Argo

Utilities

🧠 Code Mode

Built-in code-mode Prompt

💻 Local Development

📄 License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

mcp-creator-typescript

FinAgent

Built-in `code-mode` Prompt

Built-in `code-mode` Prompt