MCP 服务器

mcp-k8s-go

这个项目旨在成为一个连接到 Kubernetes 的 MCP 服务器，同时也是一个用于为 Kubernetes 中任何自定义资源构建更多服务器的库。

云平台

虚拟化

本地

Category.go

访问服务器

README

基于 Golang 的 MCP 服务器连接到 Kubernetes

<p align="center"> <a href="#features">特性</a> ⚙ <a href="#browse-with-inspector">使用 Inspector 浏览</a> ⚙ <a href="#use-with-claude">与 Claude 一起使用</a> ⚙ <a href="https://github.com/strowk/mcp-k8s-go/blob/main/CONTRIBUTING.md">贡献 ↗</a> </p>

特性

MCP 💬 提示 🗂️ 资源 🤖 工具

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

使用 Inspector 浏览

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

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

或者，要使用从源代码构建的版本，请在此项目的根文件夹中执行：

tools/inspector/run.sh

与 Claude 一起使用

以下与 Claude Desktop 的聊天演示了选择特定上下文作为资源，然后要求检查 kube-system 命名空间中 Pod 日志中的错误时的外观：

Claude Desktop

</details>

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

您有多个选项：

	<a href="#using-smithery">Smithery</a>	<a href="#using-mcp-get">mcp-get</a>	<a href="#prebuilt-from-npm">预构建 NPM</a>	<a href="#from-github-releases">GitHub 预构建</a>	<a href="#building-from-source">从源代码构建</a>	<a href="#using-docker">使用 Docker</a>
Claude 设置	自动	自动	手动	手动	手动	手动
前提条件	Node.js	Node.js	Node.js	无	Golang	Docker

使用 Smithery

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

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

使用 mcp-get

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

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

例如，对于 Claude：

{
  "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 架构的多架构镜像。

您可以像这样使用 latest 标签，例如：

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

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

对于 Claude：

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