Runpod MCP server

Этот сервер протокола контекста модели (MCP) позволяет управлять инфраструктурой Runpod через любой MCP-совместимый клиент. Он предоставляет инструменты для работы с подами, бессерверными эндпоинтами, шаблонами, сетевыми томами и аутентификацией в реестре контейнеров.

Быстрый старт

Требования

• Node.js 18 или выше.

• Учетная запись Runpod и API-ключ (получить API-ключ).

Запуск с помощью npx

Вы можете запустить сервер напрямую без установки:

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

Установка через Smithery

Для автоматической установки в Claude Desktop через Smithery:

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

Related MCP server: Quickbase MCP Server

Настройка клиента

Большинство MCP-клиентов используют JSON-файл конфигурации с общей структурой. Приведенные ниже примеры показывают подход с npx (рекомендуется для большинства пользователей) и подход с локальной сборкой (для разработки). Замените YOUR_API_KEY на ваш реальный API-ключ Runpod.

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

Откройте Cline в VS Code, нажмите на меню-гамбургер (☰) и перейдите в MCP Servers. Вы можете добавлять серверы через маркетплейс или вручную настроить их в настройках Cline, используя ту же структуру JSON, что показана выше.

JetBrains IDEs

Создайте файл mcp.json по пути ~/.junie/mcp.json (глобально) или .junie/mcp/ в вашем проекте:

{
  "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. Сервер использует два бэкенда: REST API (runpodRequest()) для аутентифицированных CRUD-операций и GraphQL API (graphqlRequest()) для публичных запросов только для чтения, таких как типы GPU и дата-центры. При добавлении новых инструментов следуйте существующим шаблонам — имена в kebab-case, схемы Zod с .describe() и ответы в формате JSON stringified.

Этот проект использует changesets для версионирования и публикации в npm. Каждый PR с изменениями, видимыми для пользователя, должен содержать файл changeset по пути .changeset/DESCRIPTIVE_NAME.md:

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

Description of what changed and why.

Используйте patch для исправлений ошибок, minor для новых инструментов или функций и major для критических изменений. Директория .changeset/ игнорируется git, поэтому используйте git add -f для добавления файлов changeset.

См. CLAUDE.md для получения полного руководства по разработке, включая детали архитектуры, соглашения об инструментах и известные проблемы.

Вопросы безопасности

Этому серверу требуется ваш API-ключ Runpod, который предоставляет полный доступ к вашей учетной записи Runpod. Никогда не передавайте свой API-ключ. Будьте осторожны с выполняемыми операциями и рассмотрите возможность создания отдельного API-ключа с ограниченными правами доступа. Не используйте этот сервер в производственной среде без принятия надлежащих мер безопасности.

Лицензия

Apache-2.0