JinDaGe - harvester-mcp-server MCP Details

article

README

🚀 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 操作。

📦 安装指南

安装步骤

克隆仓库：

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

安装依赖项：使用 Go 模块管理依赖。

go mod tidy

构建二进制文件：

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

配置 MCP 服务器

环境变量配置：
- 设置 Kubernetes 配置文件路径：

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

设置日志级别（可选）：

export LOG_LEVEL=info

启动服务器：

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

💻 使用示例

基础用法

与 Claude Desktop 配合使用

编辑配置文件：打开 ~/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"]
    }
  }
}

重启 Claude Desktop：完成配置后，重启 Claude Desktop 以应用更改。
使用 MCP 功能：现在可以在 Claude Desktop 中使用 Harvester MCP 功能了。

示例查询

"我的 Harvester 集群中有多少节点？"
"列出 cattle-system 命名空间中的所有 pods。"
"显示 cattle-system 命名空间中名为 rancher-789c976c6-xbvmd 的 pod 详情。"
"列出默认命名空间中的所有虚拟机。"
"harvester-system 命名空间中有哪些服务在运行？"

🔧 技术细节

项目结构

cmd/harvester-mcp-server/
pkg/

添加新功能

新增资源类型：在 pkg/kubernetes/types.go 中添加新的资源类型。
实现格式化器：在相应的格式化文件中为新资源实现格式化器。
注册工具：在 pkg/mcp/server.go 的 registerTools 方法中使用统一的资源处理程序注册新工具。

📄 许可证

此项目根据 Apache License 2.0 许可证分发，详细信息请参阅 LICENSE 文件。

harvester-mcp-server