cnv-lab-mcp

用于在 GLPI 中预留实验室硬件、在 Jenkins 中触发 CNV 集群部署以及导入 ACM spoke 集群的 MCP 服务器。没有硬编码任何实例 URL、硬件名称或令牌——所有内容都来自工具参数或环境变量。

添加到 Cursor

Related MCP server: DCI MCP Server

先决条件

• Node.js >= 20

• 一个 GLPI 个人 API 令牌（My Settings → API tokens）。如果实例需要，可选的 GLPI_APP_TOKEN。

• 一个 Jenkins API 令牌（User → Configure → API Token）以及短用户名，而不是电子邮件。user@example.com 返回 401；user 有效。

• GLPI 配置文件必须在目标实体上具有非零的 reservation 权限。

• Jenkins 账户需要对要触发的作业具有 Job/Build 和 Job/Read 权限。

内部 TLS / NODE_EXTRA_CA_CERTS

Node 的 fetch（undici）不像 curl 那样使用操作系统/钥匙串 CA 存储。如果 curl 有效但 MCP 服务器报告 fetch failed，请将 NODE_EXTRA_CA_CERTS 设置为你的内部 CA 捆绑包并重新启动 Cursor：

export NODE_EXTRA_CA_CERTS=/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem

TLS 错误与一般网络故障分开报告，因此这并不神秘。

配置

复制 .env.example 并设置：

示例 mcp.json 条目（通过环境变量插值传递机密）：

{
  "mcpServers": {
    "cnv-lab-mcp": {
      "command": "npx",
      "args": ["-y", "cnv-lab-mcp"],
      "env": {
        "GLPI_BASE_URL": "https://glpi.example.internal",
        "GLPI_USER_TOKEN": "${env:GLPI_USER_TOKEN}",
        "JENKINS_BASE_URL": "https://jenkins.example.internal",
        "JENKINS_USER": "${env:JENKINS_USER}",
        "JENKINS_API_TOKEN": "${env:JENKINS_API_TOKEN}",
        "NODE_EXTRA_CA_CERTS": "${env:NODE_EXTRA_CA_CERTS}"
      }
    }
  }
}

在包发布到 npm 之前，请将 args 指向此仓库：

"args": ["-y", "github:galkremer1/cnv-lab-mcp"]

工具

预留：

• list_reservable_items — 浏览 GLPI 可预留资产

• find_available_cluster — 匹配需求（结构化 + 自由文本注释）并按最早空闲时段排序。不进行预订。

• check_availability — 单个项目的预留 + 空档

• reserve_cluster — 预订一个时段；始终从会话中设置 users_id

• cancel_reservation — 释放预订

Jenkins：

• trigger_jenkins_job — 通用触发器；start_at 变为 delay=NNNsec

• get_build_status — 队列/构建 + 控制台尾部

• abort_build — 停止构建

集群访问：

• get_cluster_info — 来自 *-data.zip 的非敏感元数据和控制台/API URL

• get_cluster_kubeconfig — 仅内存中的 auth/kubeconfig + auth/kubeadmin-password。集群管理员凭据；不要在聊天中回显它们。

ACM：

• import_spoke_cluster — ManagedCluster + KlusterletAddonConfig，将导入清单应用到 spoke，轮询加入

• get_managed_cluster_status — hub 端加入/可用条件

场景（预订前确认）：

• list_scenarios

• plan_scenario — 提出集群/时段/参数，不预订任何内容

• execute_scenario — 根据计划进行预留 + 触发

内置场景位于 src/scenarios/catalog.json，可通过 PR 扩展：basic-bm-cnv、acm-hub-and-spoke、sriov-cnv-cluster。

开发

npm install
npm test
npm run lint
npm run typecheck
npm run build

针对真实实例的手动冒烟测试（不在 CI 中运行）：

npx tsx scripts/smoke.ts
SMOKE_JOB=deploy-ocp-bare-metal-cluster-with-abi-cnv-5.0 SMOKE_CLUSTER=example-cluster npx tsx scripts/smoke.ts

安全

• .env 被 gitignore。示例使用明显虚假的占位符。

• CI 在每次推送/PR 上运行 gitleaks。

• 客户端错误会编辑令牌，并且从不记录 Authorization / user_token 值。

• get_cluster_kubeconfig 将 zip 下载到 Buffer 中，并使用 JSZip 在内存中提取。它从不将存档或 auth/* 写入磁盘。

• get_cluster_info 仅读取 deploydata.json、metadata.json 和 install-config.backup.yaml。