MCP Kubernetes Server

@ductnn

代码仓库

基本信息

分类

云与基础设施

许可证

MIT license

传输方式

stdio

作者

ductnn

提交者

Duc Tran

关于 MCP Kubernetes Server

A lightweight MCP server that provides natural language processing and API access to Kubernetes clusters, combining both kubectl commands and Kubernetes Python client.

#kubernetes #mcp #mcp-server

MCP Kubernetes Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-kubernetes-server-ductnn": {
      "command": "uv",
      "args": [
        "venv",
        ".venv"
      ]
    }
  }
}

MCP Kubernetes Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Mcp Kubernetes Server?

A lightweight MCP server that provides natural language processing and API access to Kubernetes clusters, combining kubectl commands with the Kubernetes Python client. It is intended for developers and operators who want to manage Kubernetes resources through AI assistants or direct API calls.

How to use Mcp Kubernetes Server?

Install Python 3.11+, ensure kubectl is configured locally, and install UV. Clone the repository, create a virtual environment with UV, and install dependencies. Run the server with uv run main.py or configure it as an MCP server in tools like Claude Desktop by editing the claude_desktop_config.json.

Key features of Mcp Kubernetes Server

Natural language interface: convert plain English queries to kubectl commands
Full CRUD operations for namespaces, pods, and deployments
Dual execution mode: kubectl command integration and Kubernetes Python client
Namespace validation (DNS-1123 compliant)
Label filtering and grace period control
Automatic command fallback for unsupported queries

Use cases of Mcp Kubernetes Server

Manage Kubernetes clusters through AI assistants like Claude Desktop
Perform common resource operations using natural language queries
Automate pod, deployment, and namespace creation and deletion
Inspect cluster resources across all namespaces
Scale deployments and modify labels/annotations via API endpoints

常见问题

What are the prerequisites for using this server?

Python 3.11+, access to a Kubernetes cluster, kubectl configured locally, and UV installed.

How does the natural language processing work?

The server uses a natural language processor (nl_processor) that converts phrases like “Show me all pods” into equivalent kubectl commands. If a query is unsupported, it falls back to a general resource listing.

Can I create or delete Kubernetes resources with this server?

Yes, the server provides full CRUD operations via dedicated API endpoints for pods, deployments, and namespaces, including graceful deletion and force delete options.

How do I integrate this server with Claude Desktop?

Edit your `claude_desktop_config.json` to add a “kubernetes” MCP server entry pointing to the `uv` command and the project directory, then restart Claude Desktop.