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 生成代碼的實驗性質

📄 許可證

[待添加許可證詳細信息]