MCP Rancher Multi

mcp牧场主多

支持以下功能的MCP服务器 多牧场经理 后端和公开了一个丰富的工具箱，包括 舰队（GitOps） 助手。适用于MCP主机（Claude Desktop等）的stdio。

特性

• 注册许多Rancher服务器，列出/删除它们。
• Rancher v3 API助手：列出集群、节点、项目，生成kubeconfig。
• Kubernetes代理通过Rancher(/k8s/clusters/{id})使用原始直通工具。
• Fleet GitOps工具：列表/获取/创建/应用GitRepo、强制重新部署、列表BundleDeployment、状态摘要。

安装

来自NPM

npm install @gorizond/mcp-rancher-multi

发展

npm i
npm run build
node dist/index.js

码头工人

docker build -t ghcr.io//mcp-rancher-multi:0.1.16 .
docker run --rm -i \
  -e RANCHER_SERVER_prod_NAME="Rancher PROD" \
  -e RANCHER_SERVER_prod_BASEURL="https://rancher.prod.example.com" \
  -e RANCHER_SERVER_prod_TOKEN="your_token_here" \
  ghcr.io//mcp-rancher-multi:0.1.16

MCP主机配置（克劳德桌面示例）

使用NPM包

{
  "mcpServers": {
    "rancher-multi": {
      "command": "npx",
      "args": ["-y", "@gorizond/mcp-rancher-multi"],
      "env": { 
        "RANCHER_SERVER_prod_NAME": "Rancher PROD",
        "RANCHER_SERVER_prod_BASEURL": "https://rancher.prod.example.com",
        "RANCHER_SERVER_prod_TOKEN": "your_token_here"
      }
    }
  }
}

使用全局安装

{
  "mcpServers": {
    "rancher-multi": {
      "command": "mcp-rancher-multi",
      "args": [],
      "env": { 
        "RANCHER_SERVER_prod_NAME": "Rancher PROD",
        "RANCHER_SERVER_prod_BASEURL": "https://rancher.prod.example.com",
        "RANCHER_SERVER_prod_TOKEN": "your_token_here"
      }
    }
  }
}

配置

服务器配置是通过环境变量处理的。该项目支持从以下位置加载配置 .env 便于本地开发的文件：

环境文件支持

服务器自动从以下位置加载配置 .env 文件按以下顺序排列（最高优先级优先）：

1. .env.local -地方发展优先权
2. .env -默认配置

复制 env.example 到 .env 并根据您的环境进行自定义：

cp env.example .env
# Edit .env with your actual values

备注: .env 文件不应提交到版本控制，因为它们可能包含敏感信息。

配置方法

配置Rancher服务器有两种方法：

方法1：在单个环境变量中进行JSON配置

export RANCHER_SERVERS='{"prod":{"id":"prod","name":"Rancher PROD","baseUrl":"https://rancher.prod.example.com","token":"${ENV:RANCHER_TOKEN_prod}","insecureSkipTlsVerify":false},"lab":{"id":"lab","name":"Rancher LAB","baseUrl":"https://rancher.lab.example.com","token":"${ENV:RANCHER_TOKEN_lab}"}}'

方法2：个体环境变量

格式： RANCHER_SERVER__

# Production server
export RANCHER_SERVER_prod_NAME="Rancher PROD"
export RANCHER_SERVER_prod_BASEURL="https://rancher.prod.example.com"
export RANCHER_SERVER_prod_TOKEN="${ENV:RANCHER_TOKEN_prod}"
export RANCHER_SERVER_prod_INSECURESKIPTLSVERIFY="false"

# Lab server
export RANCHER_SERVER_lab_NAME="Rancher LAB"
export RANCHER_SERVER_lab_BASEURL="https://rancher.lab.example.com"
export RANCHER_SERVER_lab_TOKEN="${ENV:RANCHER_TOKEN_lab}"

# Token values
export RANCHER_TOKEN_prod="your_production_token_here"
export RANCHER_TOKEN_lab="your_lab_token_here"

看 env.example 举一个完整的例子。

安全说明

• 令牌混淆：所有令牌在日志和输出中都会自动混淆（仅显示最后4个字符 *** 前缀）

- 例子： secret_token_12345 成为 ***2345

• 做 不 日志令牌。定期轮换，尽量缩小范围。
• 对令牌等敏感数据使用环境变量。
• 考虑使用 .env 用于本地开发的文件（未提交版本控制）。
• 对于生产，请使用您平台的秘密管理系统。

工具概述

• rancher_servers_list / rancher_servers_add / rancher_servers_remove
• rancher_health
• rancher_clusters_list / rancher_cluster_get / rancher_nodes_list / rancher_projects_list
• rancher_clusters_kubeconfig / rancher_kubeconfigs_merge

- k8s_namespaces_list / k8s_raw - fleet_gitrepos_list|get|create|apply|redeploy / fleet_bdeploys_list / fleet_status_summary

处理大列表/紧凑视图

• rancher_clusters_list 默认为a 最小 视图(id + name).使用 summaryFields 从策划的摘要中包含更多内容（状态/提供者/工作区/舰队/kubeVersion等），或 summary=false 返回完整的集群对象。分页旋钮： limit, autoContinue, maxPages, maxItems，以及 continueToken （使用 pagination.next).
• rancher_cluster_get 仍然接受 summary=true 和 stripKeys 放下沉重的部分，如 links/actions.
• k8s_raw 支持 limit, autoContinue, maxPages, maxItems，自定义 accept, stripManagedFields （默认为真），以及 stripKeys （例如。 ['data','binaryData'] 删除base64有效载荷）以保持输出紧凑，同时遵循 metadata.continue.
• 车队列表工具(fleet_gitrepos_list, fleet_bdeploys_list, fleet_status_summary)接受相同的分页旋钮以及可选选项 continueToken 恢复列表，现在默认情况下返回精简摘要。使用 summary=false 或 summaryFields 以控制输出有效载荷。

测试

该项目包括一个使用Vitest的全面测试套件：

# Run all tests
npm test

# Run tests once
npm run test:run

# Run tests with coverage
npm run test:coverage

# Run tests in watch mode
npm run test:watch

测试结构

• 单元测试 (tests/unit/)：测试单个函数和类
• 集成测试 (tests/integration/)：测试MCP服务器集成
• 夹具 (tests/fixtures/)：测试数据和样本配置

覆盖

当前测试覆盖率：

• 线条: ~75%
• 函数: ~94%
• 分支: ~94%

构建单文件二进制文件

npm run bundle
# outputs dist/mcp-rancher-multi[.exe]