MCP 服务器

Github

HSn0918

开发者工具

访问服务器

README

Kubernetes MCP

English | 中文

✨ 一个使用 Go 语言设计的模型上下文协议 (MCP) 服务器实现，用于与 Kubernetes 集群交互。该服务器允许兼容 MCP 的客户端通过定义的工具执行 Kubernetes 操作。

📌 核心功能

🔹 MCP 服务器: 实现 mcp-go 库以提供 MCP 功能
🔹 Kubernetes 交互: 使用 controller-runtime 客户端与集群交互
🔹 传输方法: 支持标准 I/O (stdio) 或服务器发送事件 (sse) // 但 stdio 尚未实现

🛠️ 资源管理工具

📊 已实现的 API 组

🔸 核心 API 组 (v1)

列出、获取、描述、创建、更新、删除操作
集群范围：列出命名空间、列出节点
获取 Pod 日志功能

🔸 Apps API 组 (apps/v1)

完全支持 Deployment、ReplicaSet、StatefulSet、DaemonSet

🔸 Batch API 组 (batch/v1)

完全支持 Job、CronJob

🔸 Networking API 组 (networking.k8s.io/v1)

完全支持 Ingress、NetworkPolicy

🔸 RBAC API 组 (rbac.authorization.k8s.io/v1)

完全支持 Role、RoleBinding、ClusterRole、ClusterRoleBinding

🔸 Storage API 组 (storage.k8s.io/v1)

完全支持 StorageClass、VolumeAttachment

🔸 Policy API 组 (policy/v1beta1)

完全支持 PodSecurityPolicy、PodDisruptionBudget

🔸 API Extensions API 组 (apiextensions.k8s.io/v1)

完全支持 CustomResourceDefinition

🔸 Autoscaling API 组 (autoscaling/v1)

完全支持 HorizontalPodAutoscaler

📋 要求

📌 Go 1.24
📌 Kubernetes 集群访问 (通过 kubeconfig 或集群内服务帐户)

📦 主要依赖项

🧩 核心库:

github.com/mark3labs/mcp-go - MCP 协议实现
sigs.k8s.io/controller-runtime - Kubernetes 客户端
k8s.io/client-go - 核心 Kubernetes 库
github.com/spf13/cobra - CLI 结构
go.uber.org/zap - 日志
sigs.k8s.io/yaml - YAML 处理

🔨 构建方法

📥 从源代码构建

git clone https://github.com/HSn0918/kubernetes-mcp.git
cd kubernetes-mcp
go build -o kubernetes-mcp ./cmd/kubernetes-mcp
./kubernetes-mcp server --transport=sse --port 8080

🐳 Docker 构建

# 构建镜像
docker build -t kubernetes-mcp:latest \
  --build-arg VERSION=$(git describe --tags --always) \
  --build-arg COMMIT=$(git rev-parse HEAD) \
  --build-arg BUILD_DATE=$(date -u +"%Y-%m-%dT%H:%M:%SZ") .

# 使用 stdio 传输运行
docker run -v ~/.kube:/root/.kube kubernetes-mcp:latest server transport stdio

# 使用 SSE 传输运行
docker run -p 8080:8080 -v ~/.kube:/root/.kube kubernetes-mcp:latest server transport sse

# 使用 SSE 传输和自定义基本 URL 运行
docker run -p 8080:8080 -v ~/.kube:/root/.kube kubernetes-mcp:latest server transport sse --base-url="http://your-host:8080"

# 查看版本信息
docker run kubernetes-mcp:latest version

# 指定自定义 kubeconfig
docker run -v /path/to/config:/config kubernetes-mcp:latest server transport sse --kubeconfig=/config

🚀 用法

🔄 启动服务器

# 使用标准 I/O
./kubernetes-mcp server transport stdio

# 使用 SSE (服务器发送事件)
./kubernetes-mcp server transport sse --port 8080

# 为 SSE 连接指定自定义基本 URL
./kubernetes-mcp server transport sse --port 8080 --base-url="http://your-server-address:8080"

# 设置 CORS 允许的来源
./kubernetes-mcp server transport sse --allow-origins="*"

# 指定 Kubeconfig
./kubernetes-mcp server transport sse --kubeconfig /path/to/your/kubeconfig

# 查看版本
./kubernetes-mcp version

⚙️ 命令结构

该应用程序使用分层命令结构：

kubernetes-mcp
├── server
│   └── transport
│       ├── sse
│       │   ├── --port=8080
│       │   ├── --health-port=8081
│       │   ├── --base-url="http://example.com:8080"
│       │   └── --allow-origins="*"
│       └── stdio
└── version