Capi MCP

🚀 CAPI MCP Server

CAPI MCP Server 是一款面向 Kubernetes 集群 API（CAPI）的生产级模型上下文协议（MCP）服务器，它能让 AI 代理通过安全、标准化的接口管理 Kubernetes 集群。

🚀 快速开始

前提条件

• Go 1.24.x
• Docker 与 Docker Compose
• kubectl
• kind（用于本地测试）
• golangci-lint

操作步骤

# 克隆仓库
git clone https://github.com/capi-mcp/capi-mcp-server.git
cd capi-mcp-server

# 安装依赖
make deps

# 安装开发工具
make tools

# 运行测试
make test

# 构建服务器
make build

# 本地运行（需要设置 API_KEY 环境变量）
API_KEY=your-key make run

✨ 主要特性

V1.0 功能范围

• 基础设施提供商：AWS（通过适用于 AWS 的集群 API 提供商 - CAPA）
• 核心工具：
  • list_clusters - 列出所有托管的工作负载集群
  • get_cluster - 获取特定集群的详细信息
  • create_cluster - 根据模板创建新的工作负载集群
  • delete_cluster - 删除工作负载集群
  • scale_cluster - 扩展集群中的工作节点
  • get_cluster_kubeconfig - 获取集群访问凭证
  • get_cluster_nodes - 列出集群内的节点
• 安全方面：API 密钥认证、基于角色的访问控制（RBAC）、密钥管理
• 可观测性：结构化日志记录、Prometheus 指标

📚 详细文档

概述

CAPI MCP Server 充当 AI 代理（MCP 客户端）与 CAPI 管理集群之间的桥梁。它提供了一系列工具，将 CAPI 的复杂性抽象为简单可靠的集群生命周期管理操作。

架构

服务器采用模块化、可扩展的设计：

• 代理/网关模式：用于连接 MCP 和 CAPI
• 提供商接口：为未来的多云支持做准备
• 异步处理：处理长时间运行的 CAPI 操作
• 安全优先：采用最小权限访问原则

详细的设计文档请参考 architecture.md。

项目结构

/capi-mcp-server
├── /api/v1           # MCP 工具/资源模式
├── /cmd/server       # 应用程序入口点
├── /internal         # 私有应用程序代码
│   ├── /server       # MCP 服务器引擎
│   ├── /service      # 业务逻辑
│   ├── /kube         # CAPI 客户端包装器
│   └── /config       # 配置
├── /pkg              # 公共库
│   ├── /provider     # 提供商接口
│   └── /tools        # 工具实现
├── /deploy           # 部署工件
├── /test             # 测试套件
└── /docs             # 文档

部署

服务器作为 Kubernetes 工作负载使用 Helm 进行部署：

helm install capi-mcp-server ./deploy/charts/capi-mcp-server \
  --set auth.apiKey=$API_KEY \
  --namespace capi-system

安全

• 认证：基于 API 密钥（Bearer 令牌）
• 授权：使用 Kubernetes RBAC 实现最小权限原则
• 网络：通过网络策略进行限制
• 密钥：不记录密钥，安全处理

贡献

请阅读 CLAUDE.md 了解开发指南和标准。

路线图

项目愿景和开发阶段请参考 roadmap.md。

🔧 技术细节

AI 开发声明

⚠️ 重要提示

此仓库主要由 Anthropic 的 AI 助手 Claude Code 与人类开发者合作创建。代码、文档、测试和整体架构均通过 AI 辅助开发会话生成。 虽然代码遵循行业最佳实践并包含全面的测试，但用户应：

• 在部署到生产环境之前审查所有代码
• 了解实现的安全影响
• 验证代码是否满足其特定要求和合规标准
• 考虑在关键系统中使用 AI 生成代码的实验性质

📄 许可证

[待添加许可证详细信息]