# NVSentinel Lab

> NVSentinel Lab is an open-source MCP server for cloud and infrastructure. MCP server for testing NVIDIA NVSentinel GPU fault handling on a kind lab cluster. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted
- **Repository:** https://github.com/omerfsen/nvidia-nvsentinel-mcp
- **MCP Registry name:** io.github.omerfsen/nvidia-nvsentinel-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Go-based MCP server that lets an MCP client read what NVSentinel reports on a Kubernetes lab, inject an XID 95 fault into a simulated GPU, and check that NVSentinel cordons and drains the node. It does not install NVSentinel itself; that setup is handled by separate repositories the author links to.

The server exposes read tools for node state, scenarios, component logs and events, plus change tools (fault injection, clear, reset and end-to-end scenario runs). Changing tools are disabled by default and only work when explicitly enabled and limited to a kind cluster context whose name starts with kind-.

The README says it is aimed at people testing NVSentinel's detection and remediation pipeline in a lab. It states the results prove the pipeline against simulated DCGM, not real GPU health.

## Features

- **Read cluster state:** Reports node cordon status, NVSentinel state, failing GPU checks, pods and the workload.
- **Inject simulated GPU fault:** Injects XID 95 into the simulated GPU when change tools are enabled.
- **Wait for pipeline stage:** Polls until NVSentinel reaches a stage such as cordoned.
- **Predefined test scenarios:** Runs the xid95 and dcgm_outage scenarios end to end and reports each step.
- **Component logs and events:** Returns recent NVSentinel component log lines and events on the GPU node.
- **Lab-only safety guards:** Change tools stay off unless explicitly allowed and only work on kind contexts.

## Good for

- Testing NVSentinel fault detection and cordon behaviour on a kind cluster
- Checking that a workload is evicted and drained after a simulated GPU fault
- Letting an AI coding client inspect NVSentinel state during lab debugging
- Reproducing a DCGM outage and confirming the monitor reports it

## Install

### Claude Code (Terminal)

```sh
claude mcp add nvidia-nvsentinel-mcp -- docker run -i --rm docker.io/omerfsen/nvidia-nvsentinel-mcp:0.5.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nvidia-nvsentinel-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/omerfsen/nvidia-nvsentinel-mcp:0.5.1"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nvidia-nvsentinel-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/omerfsen/nvidia-nvsentinel-mcp:0.5.1"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nvidia-nvsentinel-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/omerfsen/nvidia-nvsentinel-mcp:0.5.1"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nvidia-nvsentinel-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/omerfsen/nvidia-nvsentinel-mcp:0.5.1"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nvidia-nvsentinel-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/omerfsen/nvidia-nvsentinel-mcp:0.5.1"
      ]
    }
  }
}
```

## Tools

- `lab_status`: Nodes (cordon, NVSentinel state, failing GPU checks), pods, the workload
- `list_scenarios`: Scenarios, stages, allowed XIDs, log sources
- `wait_for_stage`: Polls until a stage holds, such as cordoned
- `component_logs`: The last lines of a NVSentinel component's logs
- `node_events`: Recent events on the GPU node
- `inject_fault`: Injects XID 95 into the simulated GPU
- `clear_fault`: Restarts the simulated hostengine, which drops the fault
- `reset_lab`: Undoes a DCGM outage and an injected fault
- `run_test_scenario`: Runs a scenario end to end and reports each step

## FAQ

### Does this server install NVSentinel?

No. The README says it does not install NVSentinel; that is handled by separate linked repositories.

### Can it change a real cluster?

Change tools are off unless NVSENTINEL_MCP_ALLOW_CHANGES is set to exactly true, and they are meant to work only on a kind cluster.

### Does it test real GPU health?

The README says its test results prove NVSentinel's pipeline against simulated DCGM, not real GPU health, and a real GPU has not been checked.

### How is it installed?

The README lists release binaries, a go install command and a Docker image, and shows how to add it to Claude Code with claude mcp add.

### Is NVSentinel Lab free?

Yes. NVSentinel Lab is open source, so you can use and self-host it for free.

### How do I add NVSentinel Lab to Claude Code?

Run this command in your terminal: claude mcp add nvidia-nvsentinel-mcp -- docker run -i --rm docker.io/omerfsen/nvidia-nvsentinel-mcp:0.5.1

### What are the best alternatives to NVSentinel Lab?

The closest alternatives to NVSentinel Lab are Liquid Compute GPU test, XportL, Proxmox VE MCP Server, EMT Compute and MCP Canary.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Liquid Compute GPU test](https://ai-powered.com/mcp/liquid-compute-gpu-test): Liquid Compute GPU test is an MCP server for cloud and infrastructure.
- [XportL](https://ai-powered.com/mcp/xportl): XportL is a free MCP server for cloud and infrastructure.
- [Proxmox VE MCP Server](https://ai-powered.com/mcp/proxmox-ve-mcp-server): Proxmox VE MCP Server is an open-source MCP server for cloud and infrastructure.
- [EMT Compute](https://ai-powered.com/mcp/emt-compute): EMT Compute is a paid MCP server for cloud and infrastructure.
- [MCP Canary](https://ai-powered.com/mcp/mcp-canary): MCP Canary is an MCP server for developer tools.
- [ClusterValidator](https://ai-powered.com/mcp/clustervalidator): ClusterValidator is a freemium MCP server for databases.
- [Linux MCP daemon (mcpd)](https://ai-powered.com/mcp/linux-mcp-daemon-mcpd): Linux MCP daemon (mcpd) is an open-source MCP server for cloud and infrastructure.
- [Solana Rent & Rug Shield MCP Gateway](https://ai-powered.com/mcp/solana-rent-and-rug-shield-mcp-gateway): Solana Rent & Rug Shield MCP Gateway is a freemium MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/nvsentinel-lab
