基于Golang的Kubernetes连接MCP服务器

MCP K8S Go

功能特性 ⚙ 使用Inspector浏览 ⚙ 与Claude配合使用 ⚙ 贡献指南 ↗ ⚙ 关于MCP协议 ↗

功能特性

MCP 💬 提示词 🗂️ 资源 🤖 工具

• 🗂️🤖 列出Kubernetes上下文
• 💬🤖 列出Kubernetes命名空间
• 🤖 列出和获取任意Kubernetes资源
  • 包含对pods、services、deployments等资源的自定义映射，但任何资源都可以被列出和检索
• 🤖 列出Kubernetes节点
• 💬 列出Kubernetes pods
• 🤖 获取Kubernetes事件
• 🤖 获取Kubernetes pod日志
• 🤖 在Kubernetes pod中运行命令

使用Inspector浏览

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

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

与Claude配合使用

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

您有以下几种选择：

使用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架构的多架构镜像。

您可以使用最新标签，例如：

docker run -i -v ~/.kube/config:/home/nonroot/.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:/home/nonroot/.kube/config",
        "--rm",
        "mcpk8s/server:latest"
      ]
    }
  }
}

环境变量和命令行选项

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

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

支持以下命令行选项：

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