MCP Kubernetes 服务器

这是一个用于 Kubernetes 的 MCP (模型上下文协议) 服务器，它通过与 LLM 的交互来提供对 Kubernetes 集群的控制。

概述

此客户端允许您通过 MCP 工具执行常见的 Kubernetes 操作。它封装了 kubectl 命令，以提供一个简单的界面来管理 Kubernetes 资源。模型上下文协议 (MCP) 实现了语言模型和 Kubernetes 操作之间的无缝交互。

什么是 MCP？

模型上下文协议 (MCP) 是一个框架，使语言模型能够以结构化的方式与外部工具和服务进行交互。它提供：

• 一种标准化的方式来向语言模型公开功能
• 操作的上下文管理
• 工具发现和文档
• 模型和工具之间类型安全的交互

使用示例

• 为我在 production 命名空间中创建一个名为 nginx-app，镜像为 nginx:latest，具有 3 个副本的新部署。
• 将 production 命名空间中的 nginx-app 部署更新到 1.19 版本。
• 将 production 命名空间中的 nginx-app 部署扩展到 5 个副本。
• 获取 production 命名空间中的 Pod。
• 获取集群中的所有命名空间。
• 获取集群中的所有节点。
• 获取集群中的所有服务。
• 获取集群中的所有部署。
• 获取集群中的所有 Job。
• 获取集群中的所有 CronJob。
• 获取集群中的所有 StatefulSet。
• 获取集群中的所有 DaemonSet。
• 当前上下文是什么。
• 列出所有上下文。
• 切换到上下文 <context-name>。
• 获取 production 命名空间中 Pod <pod-name> 的日志。
• 获取 production 命名空间中的事件。
• 在 production 命名空间中使用 key1=value1 注释 Pod <pod-name>。
• 从 production 命名空间中的 Pod <pod-name> 中删除注释 key1。
• 将标签 key1=value1 添加到 production 命名空间中的 Pod <pod-name>。
• 从 production 命名空间中的 Pod <pod-name> 中删除标签 key1。
• 在 production 命名空间中将部署 nginx-app 暴露在 80 端口上。
• 将 production 命名空间中名称为 <resource-name> 的 pod,deployment,service 端口转发到本地端口 8080。
• 删除 production 命名空间中名称为 <resource-name> 的 pod, deployment, service, job, cronjob, statefulset, daemonset。

即将推出的功能

• 创建集群角色。
• 删除集群角色。
• 创建集群角色绑定。
• 删除集群角色绑定。
• 创建命名空间。
• 删除命名空间。
• 创建服务帐户。
• 删除服务帐户。
• 创建角色。
• 删除角色。
• 创建角色绑定。
• 删除角色绑定。

LLM 集成

此 MCP 客户端旨在与大型语言模型 (LLM) 无缝协作。这些函数使用 @mcp.tool() 进行装饰，从而可以通过模型上下文协议框架供 LLM 访问。

LLM 提示示例

LLM 可以使用自然语言与您的 Kubernetes 集群进行交互。以下是一些示例提示：

• "在 production 命名空间中创建一个具有 3 个副本的新 nginx 部署"
• "将 nginx-app 部署扩展到 5 个副本"
• "将 nginx-app 的镜像更新到 1.19 版本"

LLM 将解释这些自然语言请求，并使用正确的参数调用适当的 MCP 函数。

LLM 集成的优势

1. 自然语言界面：使用对话式语言管理 Kubernetes 资源
2. 降低命令复杂度：无需记住确切的 kubectl 语法
3. 防止错误：LLM 可以验证输入并提供有用的错误消息
4. 上下文感知：LLM 可以在多个操作中保持上下文
5. 结构化交互：MCP 确保 LLM 和工具之间类型安全且有据可查的交互

要求

• 通过 kubectl 配置的 Kubernetes 集群访问权限
• Python 3.x
• 已安装并配置的 MCP 框架

安全注意事项

将此客户端与 LLM 一起使用时，请确保：

• 为您的 Kubernetes 集群设置了适当的访问控制
• MCP 服务器在安全环境中运行
• API 访问已正确进行身份验证和授权

与 Claude Desktop 一起使用

{
    "mcpServers": {
        "Kubernetes": {
            "command": "uv",
            "args": [
                "--directory",
                "~/mcp/mcp-k8s-server",
                "run",
                "kubernetes.py"
            ]
        }
    }
}

贡献

我们欢迎对 MCP Kubernetes 服务器的贡献！如果您想贡献：

1. Fork 存储库
2. 为您的功能创建一个新分支 (git checkout -b feature/amazing-feature)
3. 进行更改
4. 根据需要编写或更新测试
5. 提交您的更改 (git commit -m 'Add some amazing feature')
6. 推送到您的分支 (git push origin feature/amazing-feature)
7. 打开一个 Pull Request

对于重大更改，请先打开一个 issue，讨论您想要更改的内容。

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Kubernetes Server：

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