Harvester MCP Server

MCP开发工具

提供方 starbops

开发工具 HTTP · 远程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor

Model Context Protocol (MCP) server for Harvester HCI

一句话选型结论

按资料字段整理

Harvester MCP Server 属于开发工具类 MCP 服务器,HTTP · 远程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式HTTP · 远程 鉴权无需鉴权 部署方式远程部署
GitHub 星标 3 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

developer-toolskubernetesgolangmcpharvester-hciKubernetes管理Go本地部署

安装与配置

HTTP · 远程 无需鉴权
连远程 HTTPS 端点,通常为 Streamable HTTP
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Harvester MCP Server当前 未标注 HTTP · 远程 远程部署 无 2026-05-18
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方starbops上游标注的维护方 starbops
分类开发工具本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验2026-05-18上游最后核验时间

详细介绍

6.6 KB
来自项目仓库与上游目录的原文,未做删改

收割机MCP服务器

Harvester HCI的模型上下文协议(MCP)服务器,使Claude Desktop、Cursor和其他AI助手能够通过MCP协议与Harvester集群进行交互。

概述

Harvester MCP服务器是一个Go实现 模型上下文协议(MCP) 专为 收割机HCI它允许像Claude Desktop和Cursor这样的AI助手在Harvester集群上执行CRUD操作,这些集群本质上是具有Harvester特定CRD的Kubernetes集群。

工作流程

下图说明了Harvester MCP Server如何弥合AI助手和Harvester集群之间的差距:```mermaid
graph LR;
subgraph "AI Assistants"
A[Claude Desktop] --> C[MCP Client];
B[Cursor IDE] --> C;
end

subgraph "Harvester MCP Server"
C --> D[MCP Server];
D --> E[Resource Handler];
E --> F[Formatter Registry];
F -->|Get Formatter| G[Core Resource Formatters];
F -->|Get Formatter| H[Harvester Resource Formatters];
end

subgraph "Kubernetes / Harvester"
G --> I[Kubernetes API];
H --> I;
I --> J[Harvester Cluster];
end

style A fill:#f9f,stroke:#333,stroke-width:2px;
style B fill:#f9f,stroke:#333,stroke-width:2px;
style D fill:#bbf,stroke:#333,stroke-width:2px;
style J fill:#bfb,stroke:#333,stroke-width:2px;


### 运作原理

1. **LLM集成**:Claude Desktop和Cursor等AI助手通过MCP协议连接到Harvester MCP服务器。
1. **请求处理**MCP服务器接收来自AI助手的自然语言请求,并将其转换为特定的Kubernetes操作。
1. **资源处理**:资源处理程序标识所请求的资源类型和操作。
1. **格式化程序选择**:格式化程序注册表为资源类型选择适当的格式化程序。
1. **API交互**:服务器与Harvester集群的Kubernetes API交互。
1. **响应格式**:结果被格式化为人类可读的文本,针对LLM消费进行了优化。
1. **用户演示文稿**:格式化的响应将返回给AI助手,以呈现给用户。

这种架构使AI助手能够通过自然语言与Harvester集群进行交互,使用户更容易访问复杂的Kubernetes操作。

## 特性

- **Kubernetes核心资源**:

- Pod:列表、获取、删除
- 部署:列表,获取
- 服务:列表,获取
- 命名空间:列表,获取
- 节点:列表,获取
- 自定义资源定义(CRD):列表

- **收割机专用资源**:

- 虚拟机:列表,获取
- 图片:列表
- 卷:列表
- 网络:列表

- **增强的用户体验**:

- 所有资源的可读格式化输出
- 按命名空间或状态自动对资源进行分组
- 包含最相关信息的简明摘要
- 全面资源检查的详细视图

## 需求

- 转到1.23+
- 使用有效的kubeconfig访问Harvester集群

## 安装

### 来源```bash
# Clone the repository
git clone https://github.com/starbops/harvester-mcp-server.git
cd harvester-mcp-server

# Build
make build

# Run
./bin/harvester-mcp-server

使用Go安装```bash

go install github.com/starbops/harvester-mcp-server/cmd/harvester-mcp-server@latest


## 配置

服务器会自动按以下顺序查找Kubernetes配置:

1. 集群内配置(如果在Kubernetes集群内运行)
1. 由指定的路径 `--kubeconfig` 旗帜
1. 由指定的路径 `KUBECONFIG` 环境变量
1. 默认位置为 `~/.kube/config`

### 命令行标志```
Usage:
harvester-mcp-server [flags]

Flags:
-h, --help                help for harvester-mcp-server
--kubeconfig string   Path to the kubeconfig file (default is $KUBECONFIG or $HOME/.kube/config)
--log-level string    Log level (debug, info, warn, error, fatal, panic) (default "info")

例子

使用特定的kubeconfig文件:```bash
harvester-mcp-server --kubeconfig=/path/to/kubeconfig.yaml


使用KUBECONFIG环境变量:```bash
export KUBECONFIG=$HOME/config.yaml
harvester-mcp-server

使用调试日志记录:```bash
harvester-mcp-server --log-level=debug


## 使用Claude Desktop

1. 安装克劳德桌面
1. 打开Claude Desktop配置文件(`~/Library/Application\ Support/Claude/claude_desktop_config.json` 或类似)
1. 将收割机MCP服务器添加到 `mcpServers` 章节:```json
{
"mcpServers": {
"harvester": {
"command": "/path/to/harvester-mcp-server",
"args": ["--kubeconfig", "/path/to/kubeconfig.yaml", "--log-level", "info"]
}
}
}
  1. 重新启动克劳德桌面
  2. 克劳德现在应该可以使用收割机MCP工具了

Claude Desktop查询示例

在Claude Desktop中配置Harvester MCP服务器后,您可以提出以下问题:

  • “我的Harvester集群中有多少节点?”
  • “列出牛系统命名空间中的所有Pod”
  • “显示牛系统命名空间中名为rancher-789c976c6-xbvmd的pod的详细信息”
  • “列出默认命名空间中的所有虚拟机”
  • “收割机系统命名空间中正在运行哪些服务?”

发展

项目结构

  • cmd/harvester-mcp-server:主要应用程序入口点
  • pkg/client:Kubernetes客户端实现
  • pkg/cmd:使用Cobra实现CLI命令
  • pkg/mcp:MCP服务器实现
  • pkg/kubernetes:Kubernetes资源的统一资源处理程序
  • pkg/tools:用于与收割机资源交互的传统工具实现

资源处理

该项目使用统一的方法来处理Kubernetes资源:

  1. 这 pkg/kubernetes/resources.go 文件包含 ResourceHandler 为所有资源类型提供通用操作:
  • 列出具有适当名称空间处理的资源
  • 按名称获取资源详细信息
  • 创建和更新资源
  • 删除资源
  1. 这 pkg/kubernetes/formatters*.go 文件包含不同资源类型的格式化程序:
  • 每个格式化程序都将原始Kubernetes对象转换为人类可读的文本
  • 以一致的方式提取和格式化特定于资源的详细信息
  • 标准Kubernetes资源和特定于Harvester的资源都有自定义格式化程序
  1. 这 pkg/kubernetes/types.go 文件将友好的资源类型名称映射到Kubernetes GroupVersionResource对象:
  • 使通过代码中的简单名称引用资源变得容易
  • 集中资源类型定义

添加新工具

要添加新工具,请执行以下操作:

  1. 如果是新的资源类型,请将其添加到 pkg/kubernetes/types.go
  2. 在其中一个格式化程序文件中实现资源的格式化程序
  3. 在中注册该工具 pkg/mcp/server.go 在 registerTools 使用统一资源处理程序的方法

格式化函数

每种资源类型都有两个格式化功能:

  1. formatXList -按命名空间分组,用简洁的信息格式化资源列表
  2. formatX -用详细信息格式化单个资源

许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。

致谢

  • 收割机HCI -该项目的基础
  • mark3labs/mcp go -用于模型上下文协议的Go SDK
  • manusa/kubernes mcp服务器 -Kubernetes MCP服务器的参考实现

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Harvester MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Harvester MCP Server 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Harvester MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Harvester MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Harvester MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Harvester MCP Server 能提供哪些能力?

资料显示能力标签包括 Kubernetes管理、Go、Claude、自然语言处理。具体工具清单以官方文档为准。

Harvester MCP Server 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Harvester MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-18。