Runpod MCPサーバー

このModel Context Protocol (MCP) サーバーを使用すると、MCP対応クライアントを通じてRunpodインフラストラクチャを管理できます。ポッド、サーバーレスエンドポイント、テンプレート、ネットワークボリューム、コンテナレジストリ認証を操作するためのツールを提供します。

クイックスタート

要件

• Node.js 18以上。

• RunpodアカウントとAPIキー (APIキーの取得)。

npxでの実行

インストールせずにサーバーを直接実行できます：

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

Smithery経由でのインストール

Smithery を介してClaude Desktopに自動的にインストールするには：

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

Related MCP server: Quickbase MCP Server

クライアントの設定

ほとんどのMCPクライアントは、同じ一般的な構造を持つJSON設定ファイルを使用します。以下の例では、npxアプローチ（ほとんどのユーザーに推奨）とローカルビルドのアプローチ（開発用）を示しています。YOUR_API_KEY を実際のRunpod APIキーに置き換えてください。

Claude Code

MCPサーバーをグローバルに追加して、すべてのプロジェクトで使用できるようにします：

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

または、特定のプロジェクトに追加します（コミット可能な .mcp.json ファイルが作成されます）：

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

claude mcp list でサーバーが接続されていることを確認します。アクティブなセッション中に再起動せずに再接続するには、/mcp と入力します。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) の設定ファイルを編集します：

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

保存後、Claude Desktopを再起動してください。

Cursor

プロジェクトディレクトリの .cursor/mcp.json、またはグローバルアクセスの場合は ~/.cursor/mcp.json に以下を追加します：

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

Windsurf

Windsurfの設定（Cmd+Shift+P → 「Open Windsurf Settings」）を開き、Cascadeセクションに移動してMCPを有効にします。次に ~/.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はVS Codeのエージェントモードで動作します（VS Code 1.101以上が必要）。ワークスペースの .vscode/mcp.json に以下を追加します：

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

サーバーエントリの横にある「Start」ボタンをクリックして接続します。

Cline

VS CodeでClineを開き、ハンバーガーメニュー (☰) をクリックして「MCP Servers」に移動します。マーケットプレイスからサーバーを追加するか、上記と同じJSON構造を使用してClineの設定で手動で構成できます。

JetBrains IDEs

~/.junie/mcp.json (グローバル) またはプロジェクト内の .junie/mcp/ に mcp.json ファイルを作成します：

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

その他のクライアント

このサーバーはstdioトランスポートを使用し、MCP対応クライアントであればどれでも動作します。設定パターンはすべてのクライアントで共通です。コマンドを npx に向け、引数として @runpod/mcp-server@latest を指定し、環境変数に RUNPOD_API_KEY を設定します。MCPクライアントの全リストについては、公式MCPクライアントページ を参照してください。

ローカルビルドの使用

リポジトリのローカルクローンから実行したい場合（開発用、または未リリースの変更をテストする場合）：

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

次に、上記の設定の command と args を以下に置き換えます：

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

ソースに変更を加えた後は、pnpm build を再実行し、MCPサーバーを再起動または再接続して変更を反映させてください。

使用例

すべてのポッドを一覧表示

Can you list all my Runpod Pods?

新しいポッドを作成

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

サーバーレスエンドポイントを作成

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

貢献

ローカル開発を開始するには、リポジトリをクローンしてビルドします：

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

変更を加えた後は、pnpm build で再ビルドしてください。Claude Codeでは、/mcp と入力するとセッションを再起動せずに更新されたサーバーに再接続できます。開発中の自動再ビルドには pnpm build:watch も使用できます。

すべてのツールは src/index.ts にあります。サーバーは2つのバックエンドを使用します。認証されたCRUD操作用のREST API (runpodRequest()) と、GPUタイプやデータセンターなどの公開読み取り専用クエリ用のGraphQL API (graphqlRequest()) です。新しいツールを追加する際は、既存のパターン（ケバブケースの名前、.describe() を使用したZodスキーマ、JSON文字列化されたレスポンス）に従ってください。

このプロジェクトは、バージョニングとnpm公開のために changesets を使用しています。ユーザー向けの変更を含むすべてのPRには、.changeset/DESCRIPTIVE_NAME.md にchangesetファイルが必要です：

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

Description of what changed and why.

バグ修正には patch、新しいツールや機能には minor、破壊的変更には major を使用してください。.changeset/ ディレクトリはgitignoredされているため、git add -f を使用してchangesetファイルをステージングしてください。

アーキテクチャの詳細、ツールの規則、既知の問題を含む完全な開発ガイドについては、CLAUDE.md を参照してください。

セキュリティに関する考慮事項

このサーバーにはRunpod APIキーが必要です。これにはRunpodアカウントへのフルアクセス権が付与されます。APIキーは絶対に共有しないでください。実行する操作には注意し、権限を制限した別のAPIキーを設定することを検討してください。適切なセキュリティ対策なしに本番環境で使用しないでください。

ライセンス

Apache-2.0