$ timeahead_
← mcp scores
85
env-doctor

Diagnose and Fix CUDA / GPU environments compatibility issues locally, in Docker, and CI/CD. CLI + MCP server available.

overview

What it does

This server diagnoses CUDA compatibility issues — the root cause of most GPU initialization failures in PyTorch, TensorFlow, JAX, and other frameworks. It scans your driver version, CUDA toolkit, cuDNN library, and installed Python packages, then identifies mismatches (e.g., driver supports CUDA 11.8 but you have 12.4 wheels installed). It can also validate Docker GPU configurations, check compute capability for specific GPU architectures, detect Python version conflicts with AI libraries, and generate safe pip install commands. The MCP integration exposes 11 tools including full environment diagnostics, component-specific checks, CUDA installation steps, and AI model memory validation.

Who it's for

Data scientists and ML engineers troubleshooting GPU initialization errors locally or in CI/CD pipelines, and platform engineers validating GPU configurations across Docker containers and distributed training setups.

Common use cases

  • Run a full CUDA/driver/cuDNN compatibility scan in seconds before attempting a fresh PyTorch installation
  • Check if a pre-trained model fits on your GPU's available memory before downloading
  • Validate Dockerfile GPU configurations for CUDA version mismatches before building
  • Generate safe pip install commands for extension libraries (flash-attn, xformers) matching your specific driver
  • Diagnose why torch.cuda.is_available() returns False on a new GPU architecture (e.g., Blackwell)

Setup pitfalls

  • Requires filesystem and network write permissions to query driver info and optionally install CUDA — consider sandboxing or restricting to trusted contexts
  • CUDA installation via --run flag requires administrative privileges; CI/CD integration needs environment-specific handling (GitHub Actions, GitLab CI, etc.)
  • Some CUDA diagnostics rely on nvidia-smi and driver-level introspection; virtualized or WSL2 environments may report incomplete GPU state
install
add to your claude desktop / cursor / windsurf mcp config:
{
  "mcpServers": {
    "env-doctor": {
      "command": "uvx",
      "args": [
        "env-doctor"
      ]
    }
  }
}
per-client install guide (claude desktop · cursor · windsurf · vscode · claude code) →
owner of this server? claim your listing to get a verified badgeclaim →
score breakdown
security (35%)100
freshness (25%)100
adoption (20%)51
quality (10%)100
trust (10%)50
score history (7 updates)
5/10/20265/19/2026
capabilities · what this server can do
tool list unavailable — permissions from static analysis·auth: API key
high risk
● active   ○ not requested  ·  hover each badge for details
fs read fs write network exec eval secrets
why high risk: fs read + fs write + network + exec + secrets active — can execute code, access credentials, and make external network calls.
maintenance health
62/ 100 · is this project alive
contributors (1y)4
top contributor share87%
releases (1y)19
last release8d ago
ci✓ passing
raw data
weekly downloads113
github stars152
forks9
open issues7
license✓ present
readme length28136 chars
last publish0d ago
last commit6d ago
last updated4h ago
install verified✓ pass · 5d ago
score drop alerts
get notified by email when this server's score drops 5+ points