Harvester MCP Server

🚀 Harvester MCP 服務器

Harvester MCP 服務器是 Harvester HCI 的 Model Context Protocol (MCP) 服務器，它讓 Claude Desktop、Cursor 等 AI 助手能通過 MCP 協議與 Harvester 集群進行交互，為用戶操作 Harvester 集群提供了便利。

🚀 快速開始

Harvester MCP Server 是 Model Context Protocol (MCP) 的 Go 實現，專為 Harvester HCI 量身打造。它能讓 Claude Desktop 和 Cursor 這類 AI 助手對 Harvester 集群執行 CRUD 操作，而這些集群本質上是帶有 Harvester 特定 CRD 的 Kubernetes 集群。

下圖展示了 Harvester MCP Server 如何架起人工智能助手與 Harvester 集群之間的橋樑：

graph LR;
    subgraph "AI 助手"
        A[Claude Desktop] --> C[MCP 客戶端];
        B[Cursor IDE] --> C;
    end
    
    subgraph "MCP 服務器"
        C --> D[Harvester MCP Server];
    end
    
    subgraph "Kubernetes 集群"
        D --> E[Kubernetes API Server];
    end

✨ 主要特性

• Harvester MCP 服務器 基於 Go 實現，允許 AI 助手如 Claude Desktop 和 Cursor 通過 MCP 協議與 Harvester 集群交互。
• 支持用戶對帶有 Harvester 特定 CRD 的 Kubernetes 集群執行 CRUD 操作。

📦 安裝指南

安裝步驟

1. 克隆倉庫：

git clone https://github.com/your-repository/harvester-mcp-server.git
cd harvester-mcp-server

2. 安裝依賴項：使用 Go 模塊管理依賴。

go mod tidy

3. 構建二進制文件：

go build -o bin/harvester-mcp-server ./cmd/harvester-mcp-server/

配置 MCP 服務器

1. 環境變量配置：
   • 設置 Kubernetes 配置文件路徑：

export KUBECONFIG=/path/to/your/kubeconfig.yaml

• 設置日誌級別（可選）：

export LOG_LEVEL=info

2. 啟動服務器：

./bin/harvester-mcp-server --kubeconfig /path/to/kubeconfig.yaml --log-level info

💻 使用示例

基礎用法

與 Claude Desktop 配合使用

1. 編輯配置文件：打開 ~/Library/Application\ Support/Claude/claude_desktop_config.json，添加 Harvester MCP 服務器到 mcpServers 中。

{
  "mcpServers": {
    "harvester": {
      "command": "/path/to/harvester-mcp-server",
      "args": ["--kubeconfig", "/path/to/kubeconfig.yaml", "--log-level", "info"]
    }
  }
}

2. 重啟 Claude Desktop：完成配置後，重啟 Claude Desktop 以應用更改。
3. 使用 MCP 功能：現在可以在 Claude Desktop 中使用 Harvester MCP 功能了。

示例查詢

• "我的 Harvester 集群中有多少節點？"
• "列出 cattle-system 命名空間中的所有 pods。"
• "顯示 cattle-system 命名空間中名為 rancher-789c976c6-xbvmd 的 pod 詳情。"
• "列出默認命名空間中的所有虛擬機。"
• "harvester-system 命名空間中有哪些服務在運行？"

🔧 技術細節

項目結構

cmd/harvester-mcp-server/
pkg/

添加新功能

1. 新增資源類型：在 pkg/kubernetes/types.go 中添加新的資源類型。
2. 實現格式化器：在相應的格式化文件中為新資源實現格式化器。
3. 註冊工具：在 pkg/mcp/server.go 的 registerTools 方法中使用統一的資源處理程序註冊新工具。

📄 許可證

此項目根據 Apache License 2.0 許可證分發，詳細信息請參閱 LICENSE 文件。