{"_id":"@atengk/mcp-server-kubernetes","_rev":"4-ca7687db7b797b01e4ba40becc9855f4","name":"@atengk/mcp-server-kubernetes","dist-tags":{"latest":"1.1.0"},"versions":{"0.0.0-stage":{"name":"@atengk/mcp-server-kubernetes","version":"0.0.0-stage","_id":"@atengk/mcp-server-kubernetes@0.0.0-stage","stub":true,"maintainers":[{"name":"atengk","email":"2385569970@qq.com"}],"dist":{"shasum":"556b1fbef1d9d655109dbb5eea8890862592bfa4","tarball":"https://registry.npmjs.org/@atengk/mcp-server-kubernetes/-/mcp-server-kubernetes-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-bKQv+pRVL+oUp6X1voFgDYuoxa478Dl3dL/NsrBqCvMJNtPhY4C2xwVGjZvaGodVQRLsfPIgTt+Gq00CeF4j7w==","signatures":[{"sig":"MEQCID5m+0WgRX2KqbmRxtH8WkfNLk/5KEfOn5zTo6X1PQPYAiByZsM0z1p1G6cyZyVQ9zn0ozjjkwYCzWhrxkjKlj5sRw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":351},"_npmUser":{"name":"atengk","email":"2385569970@qq.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@atengk/mcp-server-kubernetes","version":"0.1.0","keywords":["mcp","model-context-protocol","kubernetes","k8s","llm","ai","agent"],"author":{"name":"Ateng"},"license":"Apache-2.0","_id":"@atengk/mcp-server-kubernetes@0.1.0","maintainers":[{"name":"atengk","email":"2385569970@qq.com"}],"homepage":"https://github.com/atengk/mcp-server-kubernetes","bugs":{"url":"https://github.com/atengk/mcp-server-kubernetes/issues"},"bin":{"mcp-server-kubernetes":"bin/cli.js"},"dist":{"shasum":"5bd02a4f5d020a090129981e36d1c85f746995ed","tarball":"https://registry.npmjs.org/@atengk/mcp-server-kubernetes/-/mcp-server-kubernetes-0.1.0.tgz","fileCount":5,"integrity":"sha512-9uWHpWRfECd01t+GJZE28+YihFbTaLDI+XtnTrw2suxVavh8QoIMmClyw1SyZfCJKqsCWgkD0W3sEosGicKbNA==","signatures":[{"sig":"MEUCIQCeIByTRDRsq5LFubsSMdMAdM6TNI1Wdxp2vahWPHDIFQIgfB178X6PouUtvD9zcV+1elGsosIilZyXtxPADxVdDdo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIElMJa/O2Rw/+e7C+Lr3CsnAXP/pz/JhOYof9/A/oyBfAiBWzWTVU8z4zwLUu3bvT5iBSAN3uObCa3/pgZvYL0kmAQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15340},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"88571b7fb3a18b3d5a32f65478d614d0c20789ec","scripts":{"test":"node --test","build:packages":"node scripts/build-packages.js"},"_npmUser":{"name":"atengk","email":"2385569970@qq.com"},"repository":{"url":"git+https://github.com/atengk/mcp-server-kubernetes.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol (MCP) Server for Kubernetes - Cross-platform npm package with native Go binary distribution","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"optionalDependencies":{"@atengk/mcp-server-kubernetes-linux-x64":"0.1.0","@atengk/mcp-server-kubernetes-win32-x64":"0.1.0","@atengk/mcp-server-kubernetes-darwin-x64":"0.1.0","@atengk/mcp-server-kubernetes-linux-arm64":"0.1.0","@atengk/mcp-server-kubernetes-darwin-arm64":"0.1.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-kubernetes_0.1.0_1791362469720_0.8727589484231799","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@atengk/mcp-server-kubernetes","version":"1.0.0","keywords":["mcp","model-context-protocol","kubernetes","k8s","llm","ai","agent"],"author":{"name":"Ateng"},"license":"Apache-2.0","_id":"@atengk/mcp-server-kubernetes@1.0.0","maintainers":[{"name":"atengk","email":"2385569970@qq.com"}],"homepage":"https://github.com/atengk/mcp-server-kubernetes","bugs":{"url":"https://github.com/atengk/mcp-server-kubernetes/issues"},"bin":{"mcp-server-kubernetes":"bin/cli.js"},"dist":{"shasum":"3498cb594de57b54eb771f208a615fff86e45ec8","tarball":"https://registry.npmjs.org/@atengk/mcp-server-kubernetes/-/mcp-server-kubernetes-1.0.0.tgz","fileCount":5,"integrity":"sha512-xdsiIiOz2ZNgHprQz65P1EviwLcNMwXfdkU7/VAzqm22Cv+aK8fJ68Qk9g8in05FltXH8QBFTIkKR9Ealsv+RA==","signatures":[{"sig":"MEUCIBI3txxlDEiJtYoYdQZzUH8tdZUeyW6Y1J+7mM9zYYYGAiEA1j7/G0pjYFr7N71o4rDhmNYoiN0ygMdbfzoz7c0/YGk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDsr7qzH+Unw6xwMjCph12mg1ILVG4Z2+FSGsNThYhHWwIgRIscwgIuYJdHOfToXR7fFf2KwoGHeFGcsRECsUGE+v4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15340},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"ba420edb9b915f77f0021dcea712c26eb686a086","scripts":{"test":"node --test","build:packages":"node scripts/build-packages.js"},"_npmUser":{"name":"atengk","email":"2385569970@qq.com"},"repository":{"url":"git+https://github.com/atengk/mcp-server-kubernetes.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol (MCP) Server for Kubernetes - Cross-platform npm package with native Go binary distribution","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"optionalDependencies":{"@atengk/mcp-server-kubernetes-linux-x64":"1.0.0","@atengk/mcp-server-kubernetes-win32-x64":"1.0.0","@atengk/mcp-server-kubernetes-darwin-x64":"1.0.0","@atengk/mcp-server-kubernetes-linux-arm64":"1.0.0","@atengk/mcp-server-kubernetes-darwin-arm64":"1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server-kubernetes_1.0.0_1791362938683_0.39588870912730356","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"_id":"@atengk/mcp-server-kubernetes@1.1.0","bin":{"mcp-server-kubernetes":"bin/cli.js"},"bugs":{"url":"https://github.com/atengk/mcp-server-kubernetes/issues"},"dist":{"shasum":"e32a263b1b2aafa9a958a3e9a6e88bbc784f1cb1","tarball":"https://registry.npmjs.org/@atengk/mcp-server-kubernetes/-/mcp-server-kubernetes-1.1.0.tgz","fileCount":5,"integrity":"sha512-ilCRRbuaBBmQfbdmS9UPwhiK++6XdPBKAQ4RdhQjNoFvCNDjMYUR03ridNlkpXAo/H4eABe83Qp5+KGhOxyrCA==","signatures":[{"sig":"MEUCIQC3IUeWkEFvr9WlLkLYrcijbEGYfiAkC13J8umTRvZYYwIgO3nwjv4IKu+bMJx7I+bplvHpftnsbXOrnzu3cL+SC60=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCq4Yzvu6qRDBRYdpM1//zriSAnWz0wuwYF6e1ZsdiOFgIgLr/Z3XoTC6skCnNK2oqrK0yuJzSPp4I6Wf/6pbJ6XC8="}],"unpackedSize":16058},"name":"@atengk/mcp-server-kubernetes","type":"module","author":{"name":"Ateng"},"engines":{"node":">=18.0.0"},"gitHead":"d1c8c23e3197d8ec034d1b7d9c85787e9e0e293b","license":"Apache-2.0","scripts":{"test":"node --test","build:packages":"node scripts/build-packages.js"},"version":"1.1.0","_npmUser":{"name":"atengk","email":"2385569970@qq.com"},"homepage":"https://github.com/atengk/mcp-server-kubernetes","keywords":["mcp","model-context-protocol","kubernetes","k8s","llm","ai","agent"],"repository":{"url":"git+https://github.com/atengk/mcp-server-kubernetes.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol (MCP) Server for Kubernetes - Cross-platform npm package with native Go binary distribution","directories":{},"maintainers":[{"name":"atengk","email":"2385569970@qq.com"}],"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"optionalDependencies":{"@atengk/mcp-server-kubernetes-linux-x64":"1.1.0","@atengk/mcp-server-kubernetes-win32-x64":"1.1.0","@atengk/mcp-server-kubernetes-darwin-x64":"1.1.0","@atengk/mcp-server-kubernetes-linux-arm64":"1.1.0","@atengk/mcp-server-kubernetes-darwin-arm64":"1.1.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server-kubernetes_1.1.0_1791365250451_0.806728235793527"}}},"time":{"created":"2026-10-07T08:38:32.169Z","modified":"2026-10-07T09:27:30.700Z","0.0.0-stage":"2026-10-07T08:38:32.169Z","0.1.0":"2026-10-07T08:41:09.797Z","1.0.0":"2026-10-07T08:48:58.794Z","1.1.0":"2026-10-07T09:27:30.547Z"},"bugs":{"url":"https://github.com/atengk/mcp-server-kubernetes/issues"},"author":{"name":"Ateng"},"license":"Apache-2.0","homepage":"https://github.com/atengk/mcp-server-kubernetes","keywords":["mcp","model-context-protocol","kubernetes","k8s","llm","ai","agent"],"repository":{"url":"git+https://github.com/atengk/mcp-server-kubernetes.git","type":"git"},"description":"Model Context Protocol (MCP) Server for Kubernetes - Cross-platform npm package with native Go binary distribution","maintainers":[{"name":"atengk","email":"2385569970@qq.com"}],"readme":"# @atengk/mcp-server-kubernetes\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![npm version](https://img.shields.io/npm/v/@atengk/mcp-server-kubernetes.svg)](https://www.npmjs.com/package/@atengk/mcp-server-kubernetes)\n\nKubernetes 原生 Model Context Protocol (MCP) 服务端 Node.js 跨平台分发包。\n\n本项目为由 Go 语言编写的高性能原生二进制程序提供零依赖跨平台包装层，利用 npm 的 `optionalDependencies` 矩阵机制自动匹配当前操作系统平台与芯片架构并分发执行，无需用户在本地安装 Go 环境。\n\n---\n\n## 支持平台矩阵\n\n本包装层自动识别并支持以下 5 大主流操作系统与芯片架构：\n\n- `darwin-arm64` (macOS Apple Silicon M 系列芯片)\n- `darwin-x64` (macOS Intel 芯片)\n- `linux-x64` (Linux 64 位 x86_64)\n- `linux-arm64` (Linux 64 位 ARM aarch64)\n- `win32-x64` (Windows 64 位 x86_64)\n\n---\n\n## 快速上手\n\n### 1. 使用 `npx` 即时启动\n\n无需全局安装，直接通过 `npx` 启动 stdio 通信模式：\n\n```bash\nnpx @atengk/mcp-server-kubernetes\n```\n\n### 2. 传递启动参数\n\n所有传递给 CLI 的参数将原样透明转发至底层原生程序：\n\n```bash\n# 查看帮助文档\nnpx @atengk/mcp-server-kubernetes --help\n\n# 以 SSE HTTP 服务模式运行在 8080 端口\nnpx @atengk/mcp-server-kubernetes --transport sse --port 8080\n\n# 显式指定 kubeconfig 路径与激活 context\nnpx @atengk/mcp-server-kubernetes --kubeconfig ~/.kube/config --context dev-cluster\n\n# 显式开启写操作变更与容器 Exec 门禁\nnpx @atengk/mcp-server-kubernetes --allow-write --allow-exec\n```\n\n---\n\n## 原生支持的核心资源与常用别名\n\n无需繁琐填写 GVR，即可直接使用全称或缩写别名进行 List / Get / Describe 排障查询：\n\n- **工作负载**：`Deployment` (`deploy`), `StatefulSet` (`sts`), `DaemonSet` (`ds`)\n- **批处理**：`Job` (`job`), `CronJob` (`cj`)\n- **核心计算与网络**：`Pod` (`po`), `Service` (`svc`), `Ingress` (`ing`)\n- **持久存储**：`PersistentVolumeClaim` (`pvc`), `PersistentVolume` (`pv`)\n- **配置与安全**：`ConfigMap` (`cm`), `Secret` (强制掩码脱敏)\n- **集群元数据**：`Node` (`no`), `Namespace` (`ns`), `Event` (`ev`)\n- **第三方扩展**：所有自定义资源均可通过 `k8s_list_custom_resources` 动态反射支持。\n\n---\n\n## 在 MCP 客户端中配置\n\n### Claude Desktop\n\n在 Claude Desktop 配置文件中（macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`，Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`）添加如下配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@atengk/mcp-server-kubernetes\",\n        \"--allow-write\"\n      ]\n    }\n  }\n}\n```\n\n### Cursor / VS Code / Windsurf\n\n在相应编辑器的 MCP 配置文件中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@atengk/mcp-server-kubernetes\"\n      ]\n    }\n  }\n}\n```\n\n---\n\n## 环境变量覆盖\n\n在特殊网络环境、离线环境或容器内部，若未能从 npm 下载对应平台的子包，可通过设置环境变量显式指定本地原生二进制文件绝对路径：\n\n```bash\nexport MCP_SERVER_KUBERNETES_BINARY_PATH=/custom/path/to/mcp-server-kubernetes\nnpx @atengk/mcp-server-kubernetes\n```\n\n---\n\n## 常见排障 (Troubleshooting)\n\n- **提示未找到平台专属子包**：\n  若安装时添加了 `--no-optional` 参数，npm 将跳过平台专有子包的安装。请移除该参数或检查 npm 源中是否存在对应子包；\n- **权限问题**：\n  在 Linux 或 macOS 系统下，确保当前用户对解压出的可执行文件具有执行权限（`chmod +x`）。\n\n---\n\n## 开源协议\n\n本项目遵循 [Apache-2.0](../LICENSE) 开源协议。\n","readmeFilename":"README.md"}