gpu-rental-mcp

Ein MCP-Server zum Vergleichen und Mieten von vGPUs über Shadeform — ein einziger API-Key deckt 30+ Cloud-Provider ab (Lambda Labs, Hyperstack, TensorDock, Crusoe, Nebius, u.v.m.).

Tools

Tool	Beschreibung	Kosten
list_cheapest_gpus	Alle verfügbaren GPUs sortiert nach Preis	Kostenlos
filter_by_gpu_type	Suche nach GPU-Modell (A100, H100, RTX4090…)	Kostenlos
rent_instance	GPU-Instanz starten	⚠️ Kostet Geld
list_my_instances	Alle aktiven Instanzen anzeigen	Kostenlos
get_instance_info	Details + SSH-Zugang einer Instanz	Kostenlos
stop_instance	Instanz beenden (Abrechnung stoppt)	⚠️ Irreversibel

Alle destruktiven/kostenpflichtigen Tools haben einen confirm: true Safety-Gate.

Setup

1. API-Key holen

Registriere dich auf platform.shadeform.ai und erstelle einen API-Key.

2. Build

npm install
npm run build

3. In Claude Desktop einbinden

Füge das in ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) hinzu:

{
  "mcpServers": {
    "gpu-rental": {
      "command": "node",
      "args": ["/ABSOLUTER/PFAD/gpu-rental-mcp/dist/index.js"],
      "env": {
        "SHADEFORM_API_KEY": "dein-api-key-hier"
      }
    }
  }
}

4. In n8n einbinden (MCP Client Node)

n8n hat einen eingebauten MCP Client Node. Starte den Server als HTTP-Prozess oder nutze den stdio-Transport über einen Wrapper:

# Server als HTTP-Wrapper starten (für n8n):
SHADEFORM_API_KEY=xxx node dist/index.js

Alternativ: Den MCP Server in n8n über Execute Command oder als subprocess einbinden.

5. In Cursor / Windsurf

Gleiche Config-Struktur wie Claude Desktop, nur andere Pfade:

• Cursor: .cursor/mcp.json im Projekt oder ~/.cursor/mcp.json global
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Beispiel-Prompts

"Zeig mir die 5 günstigsten verfügbaren H100 GPUs"

"Ich brauche eine A100 mit mindestens 80GB VRAM für max. $3/Stunde"

"Starte eine RTX4090-Instanz mit dem vLLM Docker Image"

"Zeig mir alle meine aktiven GPU-Instanzen und wie viel sie bisher gekostet haben"

"Beende Instanz abc123"

Umgebungsvariablen

Variable	Pflicht	Beschreibung
SHADEFORM_API_KEY	✅	Shadeform API-Key

Shadeform Provider-Abdeckung

Shadeform aggregiert aktuell 30+ Cloud-Provider, darunter: Lambda Labs, Hyperstack, TensorDock, Crusoe Energy, Nebius, CoreWeave (via Shadeform), Vast.ai, RunPod, und weitere — alles über eine einzige API.

Free Tier: 10 API-Anfragen/Tag, 1 GPU-Instanz max, 5 Tage max-Laufzeit
Paid Tier: Unbegrenzte API-Anfragen, 100 parallele Instanzen, keine Laufzeitbegrenzung

Sicherheitshinweise

• API-Key niemals in Logs oder Ausgaben ausgeben
• rent_instance und stop_instance erfordern immer confirm: true
• Prüfe den Preis mit list_cheapest_gpus vor dem Mieten
• Instanzen laufen und kosten Geld bis du stop_instance aufrufst