AI导哈

Kubernetes集群检查工具

一个基于Python的只读MCP服务器，用于通过FastMCP和Python Kubernetes客户端检查Kubernetes集群。

  • by sandeshghanta
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 sandeshghanta/mcp-server-kubernetes-read-only

使用说明

MCP服务器Kubernetes（Python）

使用FastMCP和Python Kubernetes客户端进行Kubernetes集群检查的只读MCP服务器。

复制深受启发 Flux159/mcp服务器kubernetes

安装

uv pip install -e .

用法

uv run python -m mcp_server_k8s.server

示例用法

获取Pod

# Via Claude Code or Claude Desktop
"Show me all pods in default namespace"
"List pods with label app=nginx in production namespace"

描述资源

"Describe the deployment called my-app"
"Show details of pod my-pod-123 in namespace staging"

查看日志

"Show logs from pod my-pod"
"Get the last 50 lines of logs from deployment nginx"
"Show logs from the app container in pod multi-container-pod"

故障排除

"Diagnose issues with pods matching 'api'"
"/k8s-diagnose keyword=backend namespace=production"

健康检查

"Ping the Kubernetes cluster"
"Check if cluster is accessible"

工具参考

工具 说明 关键参数
kubectl_get 获取/列出资源 资源类型、名称、命名空间、标签选择器
kubectl_get_paginated 分页列表 资源类型、命名空间、限制、继续
kubectl_describe 详细资源信息 resourceType、名称、命名空间
kubectl_logs 容器日志 资源类型、名称、命名空间、容器、尾部
ping 健康检查 无

故障排除

“无法连接到群集”

检查：

  1. ~/.kube/config 存在且有效
  2. 当前上下文已设置： kubectl config current-context
  3. 您可以通过网络访问群集

“找不到资源”

验证：

  1. 资源名称正确
  2. 命名空间正确（默认值：“default”）
  3. 您有RBAC权限查看资源

“多容器吊舱需要容器规格”

对于具有多个容器的Pod，请指定哪个容器：

"Show logs from container nginx in pod my-pod"

Claude桌面配置

{
  "mcpServers": {
    "kubernetes": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_server_k8s.server"]
    }
  }
}

特性

  • kubectl_get-获取/列出资源
  • kubectl_get_paginated-分页资源列表
  • kubectl_describe-详细的资源描述
  • kubectl_logs-Pod/部署日志
  • ping-健康检查
  • k8s诊断提示-故障排除流程

发展

# Install dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

相关 MCP