{"_id":"k8s-readonly-mcp","_rev":"6-c7e7d448285639d16f59e8da183ca281","name":"k8s-readonly-mcp","dist-tags":{"latest":"1.0.3"},"versions":{"0.0.0-stage":{"name":"k8s-readonly-mcp","version":"0.0.0-stage","_id":"k8s-readonly-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"preetamkumar","email":"preetam0116@gmail.com"}],"dist":{"shasum":"603d8b71a70d5cdb319799bb5f4195f3c3e06381","tarball":"https://registry.npmjs.org/k8s-readonly-mcp/-/k8s-readonly-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-fMx/xvVnRAohHelUemy5VL1j+EsLUgNyJD5eGLMpFfmUIqM8ZryEDW5nYinWm/jGKKveg7pJcFROc+/jm7pLWw==","signatures":[{"sig":"MEQCICki6pldQtka0OEWdwD4NU6+zfGekpN4Es8M2Ovua7GgAiBYY2xdVX5shxrbg4c703DlAAq0BNgMvaq7/Enb7nPaYw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":338},"_npmUser":{"name":"preetamkumar","email":"preetam0116@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{},"deprecated":"Please upgrade to 1.0.3: earlier versions do not mask secret-looking environment variable values in get_pod and get_deployment output, and report only the pod phase in list_pods."},"1.0.0":{"name":"k8s-readonly-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","kubernetes","k8s","devops","sre","readonly","rbac","ai-agent","claude-code"],"author":{"name":"Preetam-3"},"license":"MIT","_id":"k8s-readonly-mcp@1.0.0","maintainers":[{"name":"preetamkumar","email":"preetam0116@gmail.com"}],"homepage":"https://github.com/Preetam-3/MCP_For_DevOps#readme","bugs":{"url":"https://github.com/Preetam-3/MCP_For_DevOps/issues"},"bin":{"k8s-readonly":"server.js","k8s-readonly-mcp":"server.js","k8s-readonly-doctor":"scripts/doctor.js","k8s-readonly-verify":"scripts/verify-readonly.js"},"dist":{"shasum":"1e37e93a7b6f662d80aa5ad56ff04b5d94049314","tarball":"https://registry.npmjs.org/k8s-readonly-mcp/-/k8s-readonly-mcp-1.0.0.tgz","fileCount":33,"integrity":"sha512-5X7HzEm89xYMDsvkmoPNPhqHUzrNAJBKi7taFIoPO6qcmDzHsjQC6YlJyJULoxikDUP3BDFrAs/5UuopLxDQxg==","signatures":[{"sig":"MEYCIQDGlDTkQ99Huq6d8GMcaJhAxxwqyW0wAflayyxAD51JbAIhAO1JtmObi9Q39J5eZXZFWN6PV4fY0Y9PBMKpCxZBEoVq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCwsR8X1yZ1PG7AZpLaO4ff4JgXl3Sjpt097svj+PvHRgIgIm0efm9DtOT+HOTIHA0CXIXvboozjpMPqMt49i0NcEo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41467},"type":"module","engines":{"node":">=22.19.0"},"gitHead":"7e95e439e92485ee505a81f0a3aa91e8f98d73f5","scripts":{"test":"node test/safety.js && node --test test/lib.test.js test/server.test.js","start":"node server.js","doctor":"node scripts/doctor.js","verify-readonly":"node scripts/verify-readonly.js"},"_npmUser":{"name":"preetamkumar","email":"preetam0116@gmail.com"},"repository":{"url":"git+https://github.com/Preetam-3/MCP_For_DevOps.git","type":"git","directory":"k8s-mcp"},"_npmVersion":"12.2.1","description":"Read-only Kubernetes MCP server for AI agents (Claude Code, Cursor, Gemini CLI, Codex CLI, VS Code Copilot). It has no write tools, and Kubernetes RBAC enforces read-only access as a second wall.","directories":{},"_nodeVersion":"26.12.0","dependencies":{"zod":"^4.6.5","@kubernetes/client-node":"^2.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/k8s-readonly-mcp_1.0.0_1792666850136_0.30281302600018734","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Please upgrade to 1.0.3: earlier versions do not mask secret-looking environment variable values in get_pod and get_deployment output, and report only the pod phase in list_pods."},"1.0.1":{"name":"k8s-readonly-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","kubernetes","k8s","devops","sre","readonly","rbac","ai-agent","claude-code"],"author":{"name":"Preetam-3"},"license":"MIT","_id":"k8s-readonly-mcp@1.0.1","maintainers":[{"name":"preetamkumar","email":"preetam0116@gmail.com"}],"homepage":"https://github.com/Preetam-3/MCP_For_DevOps#readme","bugs":{"url":"https://github.com/Preetam-3/MCP_For_DevOps/issues"},"bin":{"k8s-readonly":"server.js","k8s-readonly-mcp":"server.js","k8s-readonly-doctor":"scripts/doctor.js","k8s-readonly-verify":"scripts/verify-readonly.js"},"dist":{"shasum":"d76a34fbc2320d062488cf1e7f71ccf8245f55a5","tarball":"https://registry.npmjs.org/k8s-readonly-mcp/-/k8s-readonly-mcp-1.0.1.tgz","fileCount":36,"integrity":"sha512-54s4P5+01adZouvU5+NWihwozMkbB9njBV6GWcEqnD07iMsxlDCOxryEYZyM+B6NeCI5wfVvvP/JkSfzxmOo6g==","signatures":[{"sig":"MEUCIQC2/pJ3HjzTVB3/Agogcq63kPh8fRpA7ybCS639JpJDUAIgNc+4AiwAQK733zgmZcyTZkSTl/mvbBMcpvD1RxvNahM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC0G2hAQReFuoGr1NNIlb81axMCph9dKaPeUr1iFxKwngIgbVCs8Nyjt/SoETCA/WqsiJyUM8/4+Zqi6NZ09Y/vj+Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45596},"type":"module","engines":{"node":">=22.19.0"},"gitHead":"cc786a80037ecf2ee3c2dd966a21cdb620f7e2eb","scripts":{"test":"node test/safety.js && node --test test/lib.test.js test/server.test.js test/api-errors.test.js","start":"node server.js","doctor":"node scripts/doctor.js","verify-readonly":"node scripts/verify-readonly.js"},"_npmUser":{"name":"preetamkumar","email":"preetam0116@gmail.com"},"repository":{"url":"git+https://github.com/Preetam-3/MCP_For_DevOps.git","type":"git","directory":"k8s-mcp"},"_npmVersion":"12.2.1","description":"Read-only Kubernetes MCP server for AI agents (Claude Code, Cursor, Gemini CLI, Codex CLI, VS Code Copilot). It has no write tools, and Kubernetes RBAC enforces read-only access as a second wall.","directories":{},"_nodeVersion":"26.12.1","dependencies":{"zod":"^4.6.5","@kubernetes/client-node":"^2.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/k8s-readonly-mcp_1.0.1_1792837152589_0.49439408512858796","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Please upgrade to 1.0.3: earlier versions do not mask secret-looking environment variable values in get_pod and get_deployment output, and report only the pod phase in list_pods."},"1.0.2":{"name":"k8s-readonly-mcp","version":"1.0.2","keywords":["mcp","model-context-protocol","kubernetes","k8s","devops","sre","readonly","rbac","ai-agent","claude-code"],"author":{"name":"Preetam-3"},"license":"MIT","_id":"k8s-readonly-mcp@1.0.2","maintainers":[{"name":"preetamkumar","email":"preetam0116@gmail.com"}],"homepage":"https://github.com/Preetam-3/MCP_For_DevOps#readme","bugs":{"url":"https://github.com/Preetam-3/MCP_For_DevOps/issues"},"bin":{"k8s-readonly":"server.js","k8s-readonly-mcp":"server.js","k8s-readonly-doctor":"scripts/doctor.js","k8s-readonly-verify":"scripts/verify-readonly.js"},"dist":{"shasum":"4908994af3e4c111ae83b1896ce7d39c736d0aa5","tarball":"https://registry.npmjs.org/k8s-readonly-mcp/-/k8s-readonly-mcp-1.0.2.tgz","fileCount":36,"integrity":"sha512-QBS0yG024eOaX8qtLa/Cb0qP32jNU9kBp3qPgLFjaQ1HUQttRLyTG5t9V89m2U8M1jw31G5QVoUTOnjOy3q8Nw==","signatures":[{"sig":"MEUCIAYtXuZ/eWGzAkFeLE5pq8rT0sppFDgpkZEDuGvRVJfGAiEAtd8l/r4BaGG85+wHQUuGpVY9/egtEjPyNzEiAmWUSgw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCfjwKSfgt3nHyC088mgauK7KwF8zniz5gnziEZ+ZP0kwIgbvPPplxCsyc27wV2ie4eRqW+PHBQTPm5HZjIFhtc0Tc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46103},"type":"module","engines":{"node":">=22.19.0"},"gitHead":"2aea5b75df8d16919476791551887bcf465f46a7","scripts":{"test":"node test/safety.js && node --test test/lib.test.js test/server.test.js test/api-errors.test.js test/setup.test.js","start":"node server.js","doctor":"node scripts/doctor.js","verify-readonly":"node scripts/verify-readonly.js"},"_npmUser":{"name":"preetamkumar","email":"preetam0116@gmail.com"},"repository":{"url":"git+https://github.com/Preetam-3/MCP_For_DevOps.git","type":"git","directory":"k8s-mcp"},"_npmVersion":"12.2.1","description":"Read-only Kubernetes MCP server for AI agents (Claude Code, Cursor, Gemini CLI, Codex CLI, VS Code Copilot). It has no write tools, and Kubernetes RBAC enforces read-only access as a second wall.","directories":{},"_nodeVersion":"26.12.1","dependencies":{"zod":"^4.6.5","@kubernetes/client-node":"^2.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/k8s-readonly-mcp_1.0.2_1792856668976_0.7354015624706807","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Please upgrade to 1.0.3: earlier versions do not mask secret-looking environment variable values in get_pod and get_deployment output, and report only the pod phase in list_pods."},"1.0.3":{"name":"k8s-readonly-mcp","version":"1.0.3","keywords":["mcp","model-context-protocol","kubernetes","k8s","devops","sre","readonly","rbac","ai-agent","claude-code"],"author":{"name":"Preetam-3"},"license":"MIT","_id":"k8s-readonly-mcp@1.0.3","maintainers":[{"name":"preetamkumar","email":"preetam0116@gmail.com"}],"homepage":"https://github.com/Preetam-3/MCP_For_DevOps#readme","bugs":{"url":"https://github.com/Preetam-3/MCP_For_DevOps/issues"},"bin":{"k8s-readonly":"server.js","k8s-readonly-mcp":"server.js","k8s-readonly-doctor":"scripts/doctor.js","k8s-readonly-verify":"scripts/verify-readonly.js"},"dist":{"shasum":"2c3a3bdaf2b1e35ee8e27fecf6d409f68e57e943","tarball":"https://registry.npmjs.org/k8s-readonly-mcp/-/k8s-readonly-mcp-1.0.3.tgz","fileCount":37,"integrity":"sha512-dbGvg3qtmz8WWsjQxBfC1leIg170heSkH/7bnm0XxuCt+C0feXFqz6uR2mfcbP/9dpmE/3WQWNNu5raRqR947Q==","signatures":[{"sig":"MEUCICikFExY2IVpO4EkvUgTUQATSo2VZl/woKpec2yb3fxvAiEAiXvkS8pNzAcMa0IHLrS8mURUIKOIBXctB/Ku+p2IdYQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQD0xHEFZJJdRfIAjmFTcFsxflKZRGY5mEYncgrv63lA5wIgfOChmPC9dM97i68Bi/PNT1wUDovbbS6jEAPODU74RwA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51967},"type":"module","engines":{"node":">=22.19.0"},"gitHead":"f2101860ba498c84561cb79bfd913549f08025cf","scripts":{"test":"node test/safety.js && node --test test/lib.test.js test/server.test.js test/api-errors.test.js test/setup.test.js","start":"node server.js","doctor":"node scripts/doctor.js","verify-readonly":"node scripts/verify-readonly.js"},"_npmUser":{"name":"preetamkumar","email":"preetam0116@gmail.com"},"repository":{"url":"git+https://github.com/Preetam-3/MCP_For_DevOps.git","type":"git","directory":"k8s-mcp"},"_npmVersion":"12.2.1","description":"Read-only Kubernetes MCP server for AI agents (Claude Code, Cursor, Gemini CLI, Codex CLI, VS Code Copilot). It has no write tools, and Kubernetes RBAC enforces read-only access as a second wall.","directories":{},"_nodeVersion":"26.12.1","dependencies":{"zod":"^4.6.5","@kubernetes/client-node":"^2.0.0","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/k8s-readonly-mcp_1.0.3_1792916960173_0.873089593043181","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-10-22T10:58:10.251Z","modified":"2026-10-25T09:14:26.501Z","0.0.0-stage":"2026-10-22T10:58:10.251Z","1.0.0":"2026-10-22T11:00:50.218Z","1.0.1":"2026-10-24T10:19:12.669Z","1.0.2":"2026-10-24T15:44:29.074Z","1.0.3":"2026-10-25T08:29:20.265Z"},"bugs":{"url":"https://github.com/Preetam-3/MCP_For_DevOps/issues"},"author":{"name":"Preetam-3"},"license":"MIT","homepage":"https://github.com/Preetam-3/MCP_For_DevOps#readme","keywords":["mcp","model-context-protocol","kubernetes","k8s","devops","sre","readonly","rbac","ai-agent","claude-code"],"repository":{"url":"git+https://github.com/Preetam-3/MCP_For_DevOps.git","type":"git","directory":"k8s-mcp"},"description":"Read-only Kubernetes MCP server for AI agents (Claude Code, Cursor, Gemini CLI, Codex CLI, VS Code Copilot). It has no write tools, and Kubernetes RBAC enforces read-only access as a second wall.","maintainers":[{"name":"preetamkumar","email":"preetam0116@gmail.com"}],"readme":"# k8s-readonly-mcp\n\nA **read-only** Kubernetes MCP server for AI agents. Your agent can see pods, logs, events, deployments, services and nodes, and it **cannot change anything**.\n\nTwo independent walls enforce this:\n\n1. **Code wall:** the server registers only read tools (21 of them, all marked `readOnlyHint: true`). No delete, patch, scale, exec or restart tool exists.\n2. **Cluster wall:** you give it a ServiceAccount whose RBAC allows only `get`, `list` and `watch`. Kubernetes itself answers `403 Forbidden` to any write.\n\n## Quick start\n\n1. Create the read-only identity and credential (once). This needs the setup script from the repository:\n\n   ```bash\n   git clone https://github.com/Preetam-3/MCP_For_DevOps.git\n   cd MCP_For_DevOps\n   ./scripts/setup.sh demo 2h      # writes ./mcp.kubeconfig\n   ```\n\n2. Register the server with your agent:\n\n   ```bash\n   claude mcp add --scope user k8s-readonly -e KUBECONFIG=\"$(pwd)/mcp.kubeconfig\" -- npx -y k8s-readonly-mcp\n   ```\n\n   Config snippets for Cursor, VS Code, Gemini CLI and Codex CLI are in the repository under `docs/clients/`.\n\n**Scope of the guarantee:** it covers this server and its credential. An agent that also has a shell can still use other credentials on your machine, so for important clusters run it where only the scoped kubeconfig exists.\n\n## Check it\n\n```bash\nKUBECONFIG=./mcp.kubeconfig NAMESPACE=demo npx -y -p k8s-readonly-mcp k8s-readonly-verify   # proves writes are denied\nKUBECONFIG=./mcp.kubeconfig npx -y -p k8s-readonly-mcp k8s-readonly-doctor                  # checks your setup\n```\n\n## Configuration\n\n| Variable | Meaning |\n|---|---|\n| `KUBECONFIG` | **Required.** Path to the scoped read-only kubeconfig. The server refuses to start without it, so it never silently uses your admin credential. |\n| `K8S_READONLY_ALLOW_DEFAULT_KUBECONFIG` | Set to `1` to deliberately allow your default kubeconfig (not recommended) |\n| `NAMESPACE_ALLOWLIST` | Comma-separated namespaces the server may read (default: the namespace of the current context) |\n\n## Requirements\n\nNode.js 22.19 or newer, `kubectl`, and a Kubernetes cluster.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}