Cloud Run MCP Server

Что умеет сервер

Сервер из репозитория GoogleCloudPlatform/cloud-run-mcp позволяет ИИ-агентам, совместимым с MCP, развёртывать приложения в Cloud Run. Основные инструменты: deploy-file-contents разворачивает файлы, переданные прямо в запросе, list-services показывает сервисы Cloud Run в проекте и регионе, get-service выдаёт сведения о сервисе, get-service-log возвращает журналы и сообщения об ошибках. При локальном запуске добавляются deploy-local-folder (развернуть локальную папку), list-projects и create-project, которые создаёт проект и привязывает его к первому доступному платёжному аккаунту.

Есть и готовые промпты-ярлыки: deploy разворачивает текущий каталог, а logs показывает журналы сервиса. Если имя сервиса не указано, берётся переменная DEFAULT_SERVICE_NAME или имя текущего каталога. Репозиторий работает и как расширение Gemini CLI, и как набор навыков Cloud Run, построенных поверх gcloud CLI.

Когда использовать

Сервер удобен, когда нужно быстро выкатить небольшой сервис или прототип из чата: из IDE вроде Cursor, настольного ИИ-приложения вроде Claude, Gemini CLI или из агентных SDK, например Google Gen AI SDK или Agent Development Kit. Типичные запросы: развернуть папку как сервис, посмотреть список сервисов региона, найти причину ошибки по журналу.

README советует запускать сервер локально на Node.js с вашими локальными учётными данными Google Cloud. Альтернатива: развернуть сам сервер в Cloud Run и подключаться к нему через прокси с IAM-аутентификацией, но в этом случае выкатывать код можно только в тот же проект, где работает сервер.

Ограничения и безопасность

Агент действует с правами вашей учётной записи Google Cloud, а create-project создаёт проект с привязкой к платёжному аккаунту, поэтому такие вызовы стоит подтверждать вручную. Удалённый сервер нельзя использовать без аутентификации: README прямо предупреждает об этом и в примере закрывает доступ параметром --no-allow-unauthenticated. Проверка IAM-прав сервиса по умолчанию отключена (SKIP_IAM_CHECK равна true), проверку защиты от DNS-перепривязки (ENABLE_HOST_VALIDATION) нужно включать отдельно.

В README сказано, что условия использования Google Cloud и условия обработки данных не распространяются ни на один компонент программного обеспечения Cloud Run MCP Server. Нужны Google Cloud SDK, вход через gcloud auth login и учётные данные приложения; для запуска через npx нужен Node.js (рекомендована LTS-версия).

Подготовка

Установите Google Cloud SDK и войдите в аккаунт:

gcloud auth login
gcloud auth application-default login

Локальный сервер через Node.js (рекомендуется)

Добавьте в файл конфигурации вашего клиента MCP (синтаксис зависит от клиента):

"cloud-run": {
  "command": "npx",
  "args": ["-y", "@google-cloud/cloud-run-mcp"]
}

Необязательные значения по умолчанию:

"cloud-run": {
  "command": "npx",
  "args": ["-y", "@google-cloud/cloud-run-mcp"],
  "env": {
    "GOOGLE_CLOUD_PROJECT": "PROJECT_NAME",
    "GOOGLE_CLOUD_REGION": "PROJECT_REGION",
    "DEFAULT_SERVICE_NAME": "SERVICE_NAME"
  }
}

Docker

"cloud-run": {
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GOOGLE_APPLICATION_CREDENTIALS",
    "-v",
    "/local-directory:/local-directory",
    "mcp/cloud-run-mcp:latest"
  ],
  "env": {
    "GOOGLE_APPLICATION_CREDENTIALS": "/Users/slim/.config/gcloud/application_default-credentials.json",
    "DEFAULT_SERVICE_NAME": "SERVICE_NAME"
  }
}

Расширение Gemini CLI

gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp

Затем выполните gcloud auth login и gcloud auth application-default login.

Удалённый сервер в Cloud Run

Развёртывание закрыто для анонимных запросов, доступ идёт через IAM и локальный прокси:

gcloud config set project YOUR_PROJECT_ID
gcloud run deploy cloud-run-mcp --image us-docker.pkg.dev/cloudrun/container/mcp --no-allow-unauthenticated
gcloud run services proxy cloud-run-mcp --port=3000 --region=REGION --project=PROJECT_ID

Конфигурация клиента для прокси:

"cloud-run": {
  "url": "http://localhost:3000/sse"
}

Если клиент не поддерживает url, используйте mcp-remote:

"cloud-run": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "http://localhost:3000/sse"]
}