Skip to main content
Glama
cnv-lab-mcp
by galkremer1

cnv-lab-mcp

MCP-Server zur Reservierung von Labor-Hardware in GLPI, zum Auslösen von CNV-Cluster-Deployments in Jenkins und zum Importieren von ACM-Spoke-Clustern. Es sind keine Instanz-URLs, Hardwarenamen oder Token fest kodiert – alles stammt aus Tool-Argumenten oder Umgebungsvariablen.

Zu Cursor hinzufügen

Zu Cursor hinzufügen

Related MCP server: quads-mcp

Voraussetzungen

  • Node.js >= 20

  • Ein persönlicher GLPI-API-Token (My Settings → API tokens). Optional GLPI_APP_TOKEN, falls die Instanz einen benötigt.

  • Ein Jenkins-API-Token (User → Configure → API Token) sowie den Kurz-Benutzernamen, nicht eine E-Mail-Adresse. user@example.com liefert 401; user funktioniert.

  • Das GLPI-Profil muss auf der Ziel-Entity ein reservation-Recht ungleich Null haben.

  • Das Jenkins-Konto benötigt Job/Build und Job/Read für die Jobs, die Sie auslösen werden.

Interne TLS / NODE_EXTRA_CA_CERTS

Der fetch von Node.js (undici) verwendet nicht den OS-/Schlüsselbund-CA-Speicher, wie es curl tut. Wenn curl funktioniert, aber der MCP-Server fetch failed meldet, setzen Sie NODE_EXTRA_CA_CERTS auf Ihr internes CA-Bundle und starten Sie Cursor neu:

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

TLS-Fehler werden getrennt von allgemeinen Netzwerkfehlern gemeldet, damit das nicht rätselhaft bleibt.

Konfiguration

Kopieren Sie .env.example und setzen Sie:

Variable

Erforderlich

Hinweise

GLPI_BASE_URL

ja

Mit oder ohne /apirest.php

GLPI_USER_TOKEN

ja

Persönlicher API-Token

GLPI_APP_TOKEN

nein

Nur falls die Instanz einen benötigt

JENKINS_BASE_URL

ja

Jenkins-Root-URL

JENKINS_USER

ja

Kurz-Benutzername (nicht E-Mail)

JENKINS_API_TOKEN

ja

API-Token

Beispiel-Eintrag in mcp.json (Geheimnisse per Env-Interpolation):

{
  "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}"
      }
    }
  }
}

Bis das Paket auf npm verfügbar ist, verweisen Sie mit args stattdessen auf dieses Repository:

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

Tools

Reservierung:

  • list_reservable_items — GLPI-reservierbare Assets durchsuchen

  • find_available_cluster — Anforderungen abgleichen (strukturiert + Freitext-Kommentare) und nach dem frühesten freien Slot sortieren. Bucht nichts.

  • check_availability — Reservierungen + Lücken für ein Element

  • reserve_cluster — ein Zeitfenster buchen; setzt users_id immer aus der Sitzung

  • cancel_reservation — eine Buchung freigeben

Jenkins:

  • trigger_jenkins_job — generischer Trigger; start_at wird zu delay=NNNsec

  • get_build_status — Warteschlange/Build + Konsolenausgabe

  • abort_build — einen Build stoppen

Clusterzugriff:

  • get_cluster_info — nicht vertrauliche Metadaten und Konsolen-/API-URLs aus *-data.zip

  • get_cluster_kubeconfig — auth/kubeconfig + auth/kubeadmin-password nur im Speicher. Cluster-Admin-Zugangsdaten; geben Sie sie nicht im Chat wieder.

ACM:

  • import_spoke_cluster — ManagedCluster + KlusterletAddonConfig, Import-Manifeste auf den Spoke anwenden, Join abfragen

  • get_managed_cluster_status — Hub-seitige Join-/Verfügbarkeits-Bedingungen

Szenarien (Bestätigung vor der Buchung):

  • list_scenarios

  • plan_scenario — Cluster/Fenster/Parameter vorschlagen, nichts buchen

  • execute_scenario — aus einem Plan reservieren + auslösen

Eingebaute Szenarien liegen in src/scenarios/catalog.json und können per PR erweitert werden: basic-bm-cnv, acm-hub-and-spoke, sriov-cnv-cluster.

Entwicklung

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

Manueller Smoke-Test gegen echte Instanzen (nicht in CI ausgeführt):

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

Sicherheit

  • .env ist von Git ignoriert. Beispiele verwenden offensichtlich unechte Platzhalter.

  • CI führt bei jedem Push/PR gitleaks aus.

  • Client-Fehler maskieren Token und protokollieren niemals die Werte von Authorization / user_token.

  • get_cluster_kubeconfig lädt die Zip-Datei in einen Buffer und extrahiert sie mit JSZip im Speicher. Es schreibt weder das Archiv noch auth/* auf die Festplatte.

  • get_cluster_info liest nur deploydata.json, metadata.json und install-config.backup.yaml.

Available Tools

15 tools
abort_buildA

Stop a running or queued Jenkins build (job/{name}/{build}/stop).

Inputs: job_name (required), build_number (required).

cancel_reservationB

Delete/release a GLPI reservation by id.

Inputs: reservation_id (required).

check_availabilityA

Fetch the full reservation list for one ReservationItem (paginated correctly) and compute free gaps / the first slot of duration_minutes.

Inputs: reservation_item_id (required), earliest_start, duration_minutes.

execute_scenarioA

Execute a plan from plan_scenario: reserve each role, trigger Jenkins jobs (delayed if start is in the future). ACM import runs only if wait_timeout_seconds is set and builds complete.

Inputs: plan (required), wait_timeout_seconds.

find_available_clusterA

Find reservable clusters matching requirements and rank them by earliest free slot of duration_minutes. Proposes slots only — does not book.

Inputs: duration_minutes (required), limit, itemtype, requirements, +1 more.

get_build_statusB

Poll Jenkins queue/build state. Returns building/result and a console-log tail.

Inputs: job_name (required), queue_id, build_number.

get_cluster_infoA

Return non-sensitive cluster metadata from a deploy job *-data.zip (deploydata.json, metadata.json, console/API URLs). Does not read kubeconfig or kubeadmin-password.

Inputs: job_name (required), build_number, cluster_name.

get_cluster_kubeconfigA

Extract auth/kubeconfig and auth/kubeadmin-password from a deploy job *-data.zip in memory. Returns cluster-admin credentials — do not echo them back in chat.

Inputs: job_name (required), build_number, cluster_name.

get_managed_cluster_statusB

Read ManagedCluster join/available conditions from the hub.

Inputs: cluster_name (required), hub_kubeconfig (required).

import_spoke_clusterA

Import a spoke into an ACM hub: create ManagedCluster + KlusterletAddonConfig, fetch the generated import Secret, apply manifests to the spoke, poll until Joined/Available.

Inputs: cluster_name (required), hub_kubeconfig (required), spoke_kubeconfig (required), timeout_seconds.

list_reservable_itemsB

Search GLPI for reservable assets (default itemtype Peripheral). Returns id, name, comment/capability text, and linked ReservationItem id.

Inputs: filter, itemtype.

list_scenariosA

List built-in end-to-end scenario presets (id, name, description, overridable fields).

Inputs: no named parameters.

plan_scenarioA

Resolve a scenario into a concrete unbooked plan (candidate clusters, windows, Jenkins parameters). Books and triggers nothing.

Inputs: scenario_id (required), overrides.

reserve_clusterA

Create a GLPI reservation. Always sets users_id from the authenticated session. Re-validates for conflicts immediately before booking.

Inputs: reservation_item_id (required), end, start, comment, +1 more.

trigger_jenkins_jobA

Trigger a Jenkins job with parameters. If start_at is in the future, passes delay=NNNsec so the build does not start immediately.

Inputs: job_name (required), start_at, parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools have distinct resource-action targets, but a few boundaries could be sharper: check_availability and find_available_cluster both deal with availability, and get_cluster_info vs. get_cluster_kubeconfig both extract from the same deploy artifact. Descriptions clarify the difference well enough that an agent can usually choose correctly.

    Naming Consistency5/5

    All 15 tool names follow a consistent snake_case verb_noun convention (list, check, find, reserve, cancel, trigger, get, abort, import, plan, execute). There are no camelCase names, vague single verbs, or arbitrary suffixes.

    Tool Count5/5

    Fifteen tools is at the upper end of the ideal range but appropriate for the server's scope: reservation management, Jenkins build control, cluster artifact access, ACM import/monitoring, and scenario orchestration. Each tool covers a distinct step and no tool feels redundant.

    Completeness3/5

    The core path from finding/reserving assets, triggering and monitoring builds, extracting cluster credentials, and importing a spoke into ACM is covered. However, the lifecycle lacks cleanup operations (e.g., deleting/detaching a ManagedCluster, removing an imported spoke) and there is no dedicated way to list or look up existing reservations before canceling.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for interacting with QUADS infrastructure systems via API, enabling resource management and automation through LLM applications.
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP server for IBM Technology Zone: manage reservations end-to-end and search the catalog from Claude.
      11
      -