Kubernetes
MCP Server Kubernetes 是一个用于管理 Kubernetes 集群的 CLI 工具,支持资源操作、Helm charts、日志和端口转发。
前提条件
确保您已安装并配置:
- kubectl(在 PATH 中)
- 有效的 kubeconfig 文件(已配置上下文)
- Kubernetes 集群访问权限(如 minikube、GKE 等)
- Helm v3(可选,仅在使用 Helm 功能时需要)
使用 Claude Desktop
将以下配置添加到 Claude Desktop 配置文件中:
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": ["mcp-server-kubernetes"]
}
}
}
使用 mcp-chat
通过命令行客户端连接服务器:
# 直接启动
npx mcp-chat --server "npx mcp-server-kubernetes"
# 或使用 Claude Desktop 配置文件
# Mac
npx mcp-chat --config "~/Library/Application Support/Claude/claude_desktop_config.json"
# Windows
npx mcp-chat --config "%APPDATA%Claude\claude_desktop_config.json"
核心功能
- 资源管理:列出、创建和删除 pods、服务、部署、节点和命名空间
- 调试:获取 pod 日志、描述资源、获取 Kubernetes 事件
- Helm 支持:安装、升级和卸载 charts
- 端口转发:将本地端口转发到 pod 或服务
本地开发
git clone https://github.com/Flux159/mcp-server-kubernetes.git
cd mcp-server-kubernetes
bun install
# 开发模式(监视文件变化)
bun run dev
# 运行测试
bun run test
# 构建项目
bun run build
# 使用 Inspector 进行本地测试
npx @modelcontextprotocol/inspector node dist/index.js
验证连接
要验证与集群的连接,请在 Claude 中请求以下操作之一:
- 列出所有 pods
- 创建测试部署
- 获取集群信息
如果遇到连接问题,请在终端中运行 kubectl get pods
以确认您的凭据和连接配置正确。
更多详细信息和高级用法,请参阅完整文档或访问 GitHub 仓库。