Runpod MCP Server
Официальный MCP-сервер Runpod: агент управляет подами, Serverless-эндпоинтами, шаблонами и сетевыми томами из чата.
- 86 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Сервер действует с полными правами ключа: создает платные поды и удаляет ресурсы.
- Опасные инструменты помечены `destructiveHint`, подтверждение зависит от клиента.
Установка
- Работает в
Ручная установка
npx @runpod/mcp-server@latest addУстановщик находит клиенты и записывает конфигурацию. Режимы: hosted с входом через Runpod или local с `RUNPOD_API_KEY`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер действует с полными правами ключа: создает платные поды и удаляет ресурсы.
- Опасные инструменты помечены `destructiveHint`, подтверждение зависит от клиента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Официальный MCP-сервер Runpod, облака с GPU. Через него Claude Code, Cursor, Windsurf, VS Code и другие клиенты управляют подами, Serverless-эндпоинтами, шаблонами, сетевыми томами и реестрами образов. Старт, остановка и перезапуск пода идут одним инструментом `pod-action`, а список типов GPU отдает `list-gpu-types`. Сервер размещен на `https://mcp.runpod.io/`: клиент подключается по ссылке и входит через аккаунт Runpod, ключ на диск не пишется. Либо сервер запускают локально из npm-пакета `@runpod/mcp-server` с собственным `RUNPOD_API_KEY`. Каждый инструмент несет аннотации `readOnlyHint` и `destructiveHint`, по ним клиент подтверждает опасные вызовы.
Для кого. Инженерам, которые обучают и запускают модели на GPU Runpod и хотят поднимать поды и эндпоинты командами в чате.
Подходит, если
- Нужен под с RTX 4090 для эксперимента, а консоль открывать лень.
- Serverless-эндпоинт с лимитом воркеров создается из описания в чате.
- Агент разбирает, какие поды остались включенными и тратят деньги.
- Образ из приватного реестра подключается к поду.
- Локальный сервер в CI или скрипте работает со своим ключом API.
Не подходит, если
- Агенту нельзя доверять ключ с полными правами на аккаунт Runpod.
- Расходы на GPU нельзя тратить без ручного подтверждения каждого шага.
- Работа идет в другом облаке с GPU.
Пример запроса к агенту
Покажи все мои поды Runpod и создай под test-pod на NVIDIA GeForce RTX 4090 с одним GPU.MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Переменные окружения
`RUNPOD_API_KEY`секрет- Ключ API Runpod для локального запуска. В размещенном режиме с входом через Runpod не нужен.
Ограничения
Сервер действует с полными правами переданного ключа: создает платные поды, останавливает и удаляет ресурсы. Подтверждайте разрушающие вызовы вручную, например `delete-pod` и `purge-endpoint-queue`. Для локального запуска нужны Node.js 20 или новее и ключ API. В версии 4 восемь инструментов переименованы, а `start-pod`, `stop-pod` и `restart-pod` объединены в `pod-action`. Если вход через Runpod вернул `403`, брандмауэр временно заблокировал IP. Подождите до часа или передайте ключ заголовком `Authorization`.
Как отключить. Выполните `npx @runpod/mcp-server@latest remove` или удалите запись `runpod` из конфигурации клиента. Ключ API отзовите в консоли Runpod.
Частые вопросы
Чем отличаются режимы hosted и local?
В hosted клиент подключается к `https://mcp.runpod.io/` и входит через Runpod по OAuth, ключ не хранится. В local сервер запускается через `npx`, а `RUNPOD_API_KEY` лежит в конфигурации клиента.
Какие клиенты настраивает установщик?
`claude-code`, `cursor`, `windsurf`, `claude-desktop`, `vscode`, `opencode` и `pi`. Команда `npx @runpod/mcp-server@latest add --list` показывает найденные клиенты и пути конфигов.
Как запустить без терминала-диалога?
Назовите клиентов флагом, например `npx @runpod/mcp-server@latest add --client cursor --local`. Без `--client` и без терминала установщик выходит с кодом 2 и ничего не настраивает.
Что делать, если вход вернул 403?
Брандмауэр временно заблокировал IP после серии запросов без авторизации. Блокировка снимается за час. Чтобы не повторилось, передайте ключ API заголовком `Authorization: Bearer`.
Есть ли у сервера сбор данных?
Размещенный сервер записывает анонимное событие на вызов инструмента. Отказаться можно заголовком `X-Runpod-Analytics: off`. При локальном запуске ничего не отправляется.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыRunpod Plugins — GPU-облако для агента
Runpod Official Plugins
Плагин Runpod с 16 скиллами и MCP-сервером: агент поднимает поды, разворачивает эндпоинты и считает расходы на GPU
MCP-сервер Google для деплоя приложений в Cloud Run из агента, со списком сервисов и чтением логов
MCPM
mcpm
Менеджер пакетов и реестр MCP для всех платформ и клиентов: ищет, добавляет и настраивает MCP-серверы, запоминает источник и обновляет
Демон mcpd запускает MCP-серверы из одного файла .mcpd.toml и отдает их агентам и скриптам как обычный HTTP API на локальном порту
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
Официальный MCP-сервер Render: сервисы, деплои, логи, метрики и базы Postgres на хостинге Render
Коротко о README
Инструменты генерируются из OpenAPI-спецификации Runpod, поэтому их набор совпадает с API облака. Отдельно описан переход с версии 3.x.