mcp-k8s-go

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Connects to Kubernetes clusters to list contexts, namespaces, nodes, resources (pods, services, deployments), fetch resource details, list events, and get pod logs

特征

MCP 💬 提示 🗂️ 资源 🤖 工具

🗂️🤖 列出 Kubernetes 上下文
💬🤖 列出 Kubernetes 命名空间
🤖 列出并获取任何 Kubernetes 资源
- 包括 Pod、服务、部署等资源的自定义映射，但可以列出和检索任何资源
🤖 列出 Kubernetes 节点
💬 列出 Kubernetes pod
🤖 获取 Kubernetes 事件
🤖 获取 Kubernetes pod 日志
🤖 在 Kubernetes pod 中运行命令

使用检查器浏览

要使用 Inspector 的最新发布版本，您可以运行以下命令：

npx @modelcontextprotocol/inspector npx @strowk/mcp-k8s

，或者使用从源代码构建的版本，然后在该项目的根文件夹中：

tools/inspector/run.sh

与 Claude 一起使用

以下与 Claude Desktop 的聊天演示了当选择特定上下文作为资源并被要求检查 pod 日志中是否存在 kube-system 命名空间中的错误时的情况：

要将此 MCP 服务器与 Claude Desktop（或任何其他客户端）一起使用，您可能需要选择要使用的安装方式。

您有多种选择：

|锻造工艺|mcp-获取|预建 NPM|Github 中预建|来自来源|使用 Docker| |---|---|---|---|---|---|---| |克劳德·塞普|汽车|汽车|手动的|手动的|手动的|手动的| |先决条件|Node.js|Node.js|Node.js|没有任何|Golang|Docker|

使用 Smithery

要通过Smithery自动安装 MCP K8S Go for Claude Desktop：

npx -y @smithery/cli install @strowk/mcp-k8s --client claude

使用 mcp-get

要通过mcp-get自动安装 MCP K8S Go for Claude Desktop：

npx @michaellatman/mcp-get@latest install @strowk/mcp-k8s

使用预构建的二进制文件手动

从 npm 预构建

如果您已安装 npm 并想要使用预构建的二进制文件，请使用此功能：

npm install -g @strowk/mcp-k8s

然后通过运行mcp-k8s --version检查版本，如果打印了安装的版本，则可以继续将配置添加到claude_desktop_config.json文件：

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s",
      "args": []
    }
  }
}

或者使用npx和任何客户端：

npx @strowk/mcp-k8s

以克劳德为例：

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "npx",
      "args": [
        "@strowk/mcp-k8s"
      ]
    }
  }
}

来自 GitHub 版本

前往GitHub 发布并下载适合您平台的最新版本。

解压存档，其中包含名为mcp-k8s-go的二进制文件，将该二进制文件放在 PATH 中的某个位置，然后将以下配置添加到claude_desktop_config.json文件中：

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

从源代码构建

您需要安装 Golang 来构建此项目：

go get github.com/strowk/mcp-k8s-go
go install github.com/strowk/mcp-k8s-go

，然后在claude_desktop_config.json文件中添加如下配置：

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

使用 Docker

该服务器自 0.3.1-beta.2 版本起构建并发布到 Docker Hub，并提供适用于 linux/amd64 和 linux/arm64 架构的多架构镜像。

您可以像这样使用最新标签 fe：

docker run -i -v ~/.kube/config:/home/nonroot/.kube/config --rm mcpk8s/server:latest

Windows 用户可能至少需要在 Git Bash 中将~/.kube/config替换为//c/Users/<username>/.kube/config 。

对于克劳德来说：

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-v",
        "~/.kube/config:/home/nonroot/.kube/config",
        "--rm",
        "mcpk8s/server:latest"
      ]
    }
  }
}

环境变量和命令行选项

MCP 服务器使用以下环境变量：

KUBECONFIG ：Kubernetes 配置文件的路径（可选，默认为 ~/.kube/config）

支持以下命令行选项：

--allowed-contexts=<ctx1,ctx2,...> ：允许用户访问的 Kubernetes 上下文列表（以逗号分隔）。如果未指定，则允许所有上下文。
--help ：显示帮助信息
--version ：显示版本信息

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

该项目旨在作为连接到 Kubernetes 的 MCP 服务器和用于为 Kubernetes 中的任何自定义资源构建更多服务器的库。