Kubeview
Read-only Kubernetes diagnostics through a sandboxed TypeScript runtime
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 2.4.0
- Listing updated
- today
Similar MCP servers
About Kubeview
Kubeview is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Instead of publishing dozens of tools, Kubeview gives the agent a single run_code tool that executes bounded TypeScript. Inside that sandbox, code can query Kubernetes, Helm, Argo Workflows and Argo CD, correlate the results and return only the answer, so intermediate payloads never enter the model's context window. The README credits Anthropic's code-execution-with-MCP pattern.
The only other public tool is kube_pod_exec, which is gated by approval: it needs MCP elicitation, is bound to the argument digest and expires after 10 minutes. Port forwarding is denied in code mode by default. Argo is detected from the Kubernetes API, and Helm releases are read from cluster Secrets or ConfigMaps with a local helm binary only as a fallback.
It runs over stdio by default via npx, needs Node.js 22 or later and a kubeconfig, and has an optional HTTP mode that requires an approval signing secret.
Install
Run in a terminal
claude mcp add kubeview --env MCP_APPROVAL_STATE_SECRET='<MCP_APPROVAL_STATE_SECRET>' -- npx -y kubeview-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"kubeview": {
"command": "npx",
"args": [
"-y",
"kubeview-mcp"
],
"env": {
"MCP_APPROVAL_STATE_SECRET": "<MCP_APPROVAL_STATE_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"kubeview": {
"command": "npx",
"args": [
"-y",
"kubeview-mcp"
],
"env": {
"MCP_APPROVAL_STATE_SECRET": "<MCP_APPROVAL_STATE_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"kubeview": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kubeview-mcp"
],
"env": {
"MCP_APPROVAL_STATE_SECRET": "<MCP_APPROVAL_STATE_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"kubeview": {
"command": "npx",
"args": [
"-y",
"kubeview-mcp"
],
"env": {
"MCP_APPROVAL_STATE_SECRET": "<MCP_APPROVAL_STATE_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"kubeview": {
"command": "npx",
"args": [
"-y",
"kubeview-mcp"
],
"env": {
"MCP_APPROVAL_STATE_SECRET": "<MCP_APPROVAL_STATE_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
KUBECONFIGPath to kubeconfig file; defaults to ~/.kube/config if unset.MCP_TRANSPORTTransport mode: 'stdio' (default) or 'http'. The published package metadata still targets stdio by default.MCP_MODEServer mode: 'code' (default), compatibility alias 'all', or direct 'tools'.MCP_CODE_MODE_DISABLED_TOOLSComma-separated configurable denials inside run_code. Environment overrides JSON; an empty value enables all configurable capabilities.MCP_ARGO_TOOLSArgo Workflows capability override: auto, on, or off. Auto uses Kubernetes API discovery.MCP_ARGOCD_TOOLSArgo CD capability override: auto, on, or off. Auto uses Kubernetes API discovery or explicit remote configuration.MCP_LOG_LEVELLogging level: 'error', 'warn', 'info' (default), or 'debug'.MCP_KUBE_CONTEXTKubernetes context name to use. If unset, uses the current context from kubeconfig.MCP_K8S_SKIP_TLS_VERIFYSkip TLS certificate verification for Kubernetes API (use 'true' or '1'). Not recommended for production.MCP_HIDE_SENSITIVEEnable global sensitive data masking. Set to 'true' or '1' to mask sensitive values in responses.MCP_TIMEOUTDefault timeout in milliseconds for operations. If unset, uses plugin-specific defaults.MCP_HTTP_HOSTHTTP bind host when MCP_TRANSPORT=http. Defaults to 127.0.0.1.MCP_HTTP_PORTHTTP port when MCP_TRANSPORT=http. Defaults to 3000.MCP_HTTP_PATHHTTP endpoint path when MCP_TRANSPORT=http. Defaults to /mcp.MCP_HTTP_JSON_RESPONSEPrefer JSON responses over SSE in HTTP mode. Set to 'true' or '1' to enable.MCP_APPROVAL_STATE_SECRETShared secret of at least 32 bytes for signing approval state. Required in HTTP mode and identical across replicas.MCP_APPROVAL_REPLAY_DIRAbsolute directory on writable storage shared by every HTTP replica, used to atomically prevent approval replay.MCP_ALLOWED_HOSTSComma-separated Host allowlist for HTTP mode. Required when binding to 0.0.0.0 or ::.MCP_ALLOWED_ORIGINSComma-separated Origin allowlist for HTTP mode.MCP_DISABLE_KUBERNETES_PLUGINDisable Kubernetes plugin. Set to 'true' or '1' to disable.MCP_DISABLE_HELM_PLUGINDisable Helm plugin. Set to 'true' or '1' to disable.MCP_DISABLE_ARGO_PLUGINDeprecated alias for MCP_ARGO_TOOLS=off.MCP_DISABLE_ARGOCD_PLUGINDeprecated alias for MCP_ARGOCD_TOOLS=off.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- run_code
- Runs sandboxed TypeScript that queries Kubernetes, Helm, Argo Workflows and Argo CD.
- kube_pod_exec
- Approval-gated command execution in a pod.
What it does
- Single code tool
- run_code runs sandboxed TypeScript across Kubernetes, Helm and Argo.
- Approval-gated exec
- kube_pod_exec needs elicitation and expires after 10 minutes.
- Argo discovery
- Detects Argo Workflows and Argo CD from the Kubernetes API.
- Sensitive masking
- An option masks sensitive values in responses.
- Context allowlist
- Limits which kube contexts the server can use.
- HTTP mode
- Optional streamable HTTP transport with signed approvals.
Good for
- Find unhealthy pods and pull their recent logs in one call
- Diff Helm release state across environments
- Correlate events and metrics during an incident
- Inspect Argo CD or Argo Workflows state from an assistant
Pricing
Open source
Kubeview FAQ
Can it change my cluster?
It is described as read-only. The one exception is the approval-gated kube_pod_exec.
What do I need to run it?
Node.js 22 or later and access to a cluster through KUBECONFIG or an in-cluster service account.
Does it run over HTTP?
Yes, optionally. HTTP mode refuses to start without an approval signing secret and replay directory.
What licence is it?
The README badge shows MIT.
Is Kubeview free?
Yes. Kubeview is open source, so you can use and self-host it for free.
How do I add Kubeview to Claude Code?
Run this command in your terminal: claude mcp add kubeview --env MCP_APPROVAL_STATE_SECRET='<MCP_APPROVAL_STATE_SECRET>' -- npx -y kubeview-mcp
What are the best alternatives to Kubeview?
The closest alternatives to Kubeview are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


