Mcp Kubernetes Server

Name: Mcp Kubernetes Server
Author: ductnn

@ductnn

关于 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

基本信息

分类

云与基础设施

许可证

MIT license

运行时

python

传输方式

stdio

发布者

ductnn

提交者

Duc Tran

配置

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

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

工具

未检测到工具

工具是从 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

FAQ from Mcp Kubernetes Server

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.