Runpod MCP-Server

Dieser Model Context Protocol (MCP)-Server ermöglicht es Ihnen, die Runpod-Infrastruktur über jeden MCP-kompatiblen Client zu verwalten. Er bietet Tools für die Arbeit mit Pods, Serverless-Endpunkten, Vorlagen, Netzwerk-Volumes und Container-Registry-Authentifizierungen.

Schnellstart

Voraussetzungen

• Node.js 18 oder höher.

• Ein Runpod-Konto und ein API-Schlüssel (holen Sie sich Ihren API-Schlüssel).

Ausführung mit npx

Sie können den Server direkt ohne Installation ausführen:

RUNPOD_API_KEY=YOUR_API_KEY npx @runpod/mcp-server@latest

Installation über Smithery

Zur automatischen Installation für Claude Desktop über Smithery:

npx -y @smithery/cli install @runpod/runpod-mcp-ts --client claude

Related MCP server: Quickbase MCP Server

Einrichtung mit Ihrem Client

Die meisten MCP-Clients verwenden eine JSON-Konfigurationsdatei mit der gleichen allgemeinen Struktur. Die folgenden Beispiele zeigen den npx-Ansatz (für die meisten Benutzer empfohlen) und den lokalen Build-Ansatz (für die Entwicklung). Ersetzen Sie YOUR_API_KEY durch Ihren tatsächlichen Runpod-API-Schlüssel.

Claude Code

Fügen Sie den MCP-Server global hinzu, damit er in all Ihren Projekten verfügbar ist:

claude mcp add runpod -s user \
  -e RUNPOD_API_KEY=YOUR_API_KEY \
  -- npx -y @runpod/mcp-server@latest

Oder fügen Sie ihn einem bestimmten Projekt hinzu (erstellt eine .mcp.json-Datei, die Sie committen können):

claude mcp add runpod -s project \
  -e RUNPOD_API_KEY=YOUR_API_KEY \
  -- npx -y @runpod/mcp-server@latest

Überprüfen Sie mit claude mcp list, ob der Server verbunden ist. Wenn Sie sich in einer aktiven Sitzung befinden, geben Sie /mcp ein, um die Verbindung wiederherzustellen, ohne neu zu starten.

Claude Desktop

Bearbeiten Sie die Konfigurationsdatei unter ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu.

Cursor

Fügen Sie Folgendes zu .cursor/mcp.json in Ihrem Projektverzeichnis oder ~/.cursor/mcp.json für den globalen Zugriff hinzu:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Öffnen Sie die Windsurf-Einstellungen (Cmd+Shift+P → "Open Windsurf Settings"), navigieren Sie zum Abschnitt Cascade und aktivieren Sie MCP. Bearbeiten Sie dann ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

MCP funktioniert im Agent-Modus von VS Code (erfordert VS Code 1.101+). Fügen Sie Folgendes zu .vscode/mcp.json in Ihrem Arbeitsbereich hinzu:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Klicken Sie auf die Schaltfläche "Start" neben dem Servereintrag, um eine Verbindung herzustellen.

Cline

Öffnen Sie Cline in VS Code, klicken Sie auf das Hamburger-Menü (☰) und gehen Sie zu MCP Servers. Sie können Server über den Marketplace hinzufügen oder manuell in den Cline-Einstellungen unter Verwendung der oben gezeigten JSON-Struktur konfigurieren.

JetBrains IDEs

Erstellen Sie eine mcp.json-Datei unter ~/.junie/mcp.json (global) oder .junie/mcp/ in Ihrem Projekt:

{
  "mcpServers": {
    "runpod": {
      "command": "npx",
      "args": ["-y", "@runpod/mcp-server@latest"],
      "env": {
        "RUNPOD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Andere Clients

Dieser Server verwendet den stdio-Transport und funktioniert mit jedem MCP-kompatiblen Client. Das Konfigurationsmuster ist bei allen Clients gleich – verweisen Sie den Befehl auf npx mit @runpod/mcp-server@latest als Argument und setzen Sie RUNPOD_API_KEY in der Umgebung. Eine vollständige Liste der MCP-Clients finden Sie auf der offiziellen MCP-Client-Seite.

Verwendung eines lokalen Builds

Wenn Sie von einem lokalen Klon des Repos aus ausführen möchten (für die Entwicklung oder zum Testen unveröffentlichter Änderungen):

git clone https://github.com/runpod/runpod-mcp.git
cd runpod-mcp
pnpm install
pnpm build

Ersetzen Sie dann command und args in einer der oben genannten Konfigurationen durch:

{
  "command": "node",
  "args": ["/absolute/path/to/runpod-mcp/dist/index.mjs"]
}

Nachdem Sie Änderungen am Quellcode vorgenommen haben, führen Sie pnpm build erneut aus und starten Sie den MCP-Server neu oder verbinden Sie ihn erneut, damit die Änderungen wirksam werden.

Anwendungsbeispiele

Alle Pods auflisten

Can you list all my Runpod Pods?

Einen neuen Pod erstellen

Create a new Runpod Pod with the following specifications:
- Name: test-pod
- Image: runpod/pytorch:2.1.0-py3.10-cuda11.8.0-devel-ubuntu22.04
- GPU Type: NVIDIA GeForce RTX 4090
- GPU Count: 1

Einen Serverless-Endpunkt erstellen

Create a Runpod Serverless endpoint with the following configuration:
- Name: my-endpoint
- Template ID: 30zmvf89kd
- Minimum workers: 0
- Maximum workers: 3

Mitwirken

Um mit der lokalen Entwicklung zu beginnen, klonen Sie das Repo und bauen Sie es:

git clone https://github.com/runpod/runpod-mcp.git
cd runpod-mcp
pnpm install
pnpm build

Nachdem Sie Änderungen vorgenommen haben, bauen Sie mit pnpm build neu. Geben Sie in Claude Code /mcp ein, um die Verbindung zum aktualisierten Server wiederherzustellen, ohne Ihre Sitzung neu zu starten. Sie können auch pnpm build:watch für die automatische Neuerstellung während der Entwicklung verwenden.

Alle Tools befinden sich in src/index.ts. Der Server verwendet zwei Backends: die REST-API (runpodRequest()) für authentifizierte CRUD-Operationen und die GraphQL-API (graphqlRequest()) für öffentliche schreibgeschützte Abfragen wie GPU-Typen und Rechenzentren. Befolgen Sie beim Hinzufügen neuer Tools die vorhandenen Muster – Kebab-Case-Namen, Zod-Schemas mit .describe() und als JSON stringifizierte Antworten.

Dieses Projekt verwendet changesets für die Versionierung und npm-Veröffentlichung. Jeder PR mit benutzerseitigen Änderungen benötigt eine Changeset-Datei unter .changeset/DESCRIPTIVE_NAME.md:

---
"@runpod/mcp-server": minor
---

Description of what changed and why.

Verwenden Sie patch für Fehlerbehebungen, minor für neue Tools oder Funktionen und major für Breaking Changes. Das Verzeichnis .changeset/ wird von git ignoriert, verwenden Sie also git add -f, um Changeset-Dateien bereitzustellen.

Siehe CLAUDE.md für den vollständigen Entwicklungsleitfaden einschließlich Architekturdetails, Tool-Konventionen und bekannter Probleme.

Sicherheitshinweise

Dieser Server benötigt Ihren Runpod-API-Schlüssel, der vollen Zugriff auf Ihr Runpod-Konto gewährt. Geben Sie Ihren API-Schlüssel niemals weiter. Seien Sie vorsichtig bei den Vorgängen, die Sie ausführen, und erwägen Sie die Einrichtung eines separaten API-Schlüssels mit eingeschränkten Berechtigungen. Verwenden Sie dies nicht in einer Produktionsumgebung ohne angemessene Sicherheitsmaßnahmen.

Lizenz

Apache-2.0