MCP K8s Go

🚀 基於 Golang 的 MCP 服務器連接到 Kubernetes

本項目實現了基於 Golang 的 MCP 服務器與 Kubernetes 的連接，支持列出和切換多個 Kubernetes 集群配置，還可通過指定允許的上下文增強安全性，同時提供了多種安裝和使用方式，方便靈活配置。

✨ 主要特性

• 支持多集群配置：可以列出和切換多個 Kubernetes 集群配置。
• 上下文訪問控制：支持指定允許訪問的 Kubernetes 上下文，增強安全性。
• 環境變量靈活配置：通過設置 KUBECONFIG 環境變量，可以靈活指定 Kubernetes 配置文件路徑。
• 命令行選項限制：提供 --allowed-contexts 選項，限制用戶可訪問的 Kubernetes 上下文範圍。

📦 安裝指南

使用預構建二進制文件

通過 npm 安裝

npm install -g @strowk/mcp-k8s

然後檢查版本是否正確輸出：

mcp-k8s --version

在 claude_desktop_config.json 中添加以下配置：

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

通過 GitHub 發佈版本

從 GitHub 發佈頁面 下載對應平臺的最新版本，解壓後將可執行文件添加到 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 系統中，可能需要將路徑調整為類似 //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"
      ]
    }
  }
}

📚 詳細文檔

環境變量

命令行選項