Google Cloud Run에 코드를 배포하는 MCP 서버

MCP 호환 AI 에이전트가 Cloud Run에 앱을 배포할 수 있게 합니다.

"mcpServers":{
  "cloud-run": {
    "command": "npx",
    "args": ["-y", "https://github.com/GoogleCloudPlatform/cloud-run-mcp"]
  }
}

AI 기반 IDE에서 배포:

AI 어시스턴트 앱에서 배포:

Google Gen AI SDK 또는 Agent Development Kit 같은 에이전트 SDK에서 배포할 수 있습니다.

[!NOTE]
이 저장소는 Cloud Run에 코드를 배포하는 MCP 서버에 대한 것입니다. Cloud Run에서 MCP 서버를 호스팅하는 방법을 알아보려면 Cloud Run 문서를 방문하세요.

도구

• deploy-file-contents: 파일 내용을 직접 제공하여 Cloud Run에 파일을 배포합니다.

• list-services: 주어진 프로젝트 및 리전의 Cloud Run 서비스를 나열합니다.

• get-service: 특정 Cloud Run 서비스의 세부 정보를 가져옵니다.

• get-service-log: 특정 Cloud Run 서비스의 로그 및 오류 메시지를 가져옵니다.

• deploy-local-files*: 로컬 파일 시스템의 파일을 Google Cloud Run 서비스에 배포합니다.

• deploy-local-folder*: 로컬 폴더를 Google Cloud Run 서비스에 배포합니다.

• list-projects*: 사용 가능한 GCP 프로젝트를 나열합니다.

• create-project*: 새 GCP 프로젝트를 만들고 사용 가능한 첫 번째 결제 계정에 연결합니다. 프로젝트 ID를 선택적으로 지정할 수 있습니다.

* 로컬에서 실행할 때만 사용 가능

Related MCP server: Cloud Run MCP Server

로컬 MCP 서버로 사용

로컬 Google Cloud 자격 증명을 사용하여 로컬 머신에서 Cloud Run MCP 서버를 실행합니다. 이 방법은 AI 지원 IDE(예: Cursor) 또는 데스크톱 AI 애플리케이션(예: Claude)을 사용하는 경우에 가장 적합합니다.

1. Node.js를 설치합니다(LTS 버전 권장).

2. Google Cloud SDK를 설치하고 Google 계정으로 인증합니다.

3. 다음 명령어로 Google Cloud 계정에 로그인합니다.

   gcloud auth login

4. 다음 명령어로 애플리케이션 자격 증명을 설정합니다.

   gcloud auth application-default login

5. MCP 클라이언트의 MCP 구성 파일을 다음과 같이 업데이트합니다.

      "cloud-run": {
        "command": "npx",
        "args": ["-y", "https://github.com/GoogleCloudPlatform/cloud-run-mcp"]
      }

원격 MCP 서버로 사용

[!WARNING]
인증 없이 원격 MCP 서버를 사용하지 마세요. 다음 지침에서는 IAM 인증을 사용하여 로컬 머신에서 MCP 서버로의 연결을 보호합니다. 이는 Google Cloud 리소스에 대한 무단 액세스를 방지하는 데 중요합니다.

Cloud Run MCP 서버 자체를 Cloud Run에서 실행하고, 로컬 머신의 연결은 IAM을 통해 인증합니다. 이 옵션을 사용하면 MCP 서버가 실행 중인 것과 동일한 Google Cloud 프로젝트에만 코드를 배포할 수 있습니다.

1. Google Cloud SDK를 설치하고 Google 계정으로 인증합니다.

2. 다음 명령어로 Google Cloud 계정에 로그인합니다.

   gcloud auth login

3. 다음 명령어로 Google Cloud 프로젝트 ID를 설정합니다.

   gcloud config set project YOUR_PROJECT_ID

4. Cloud Run MCP 서버를 Cloud Run에 배포합니다.

   gcloud run deploy cloud-run-mcp --image us-docker.pkg.dev/cloudrun/container/mcp --no-allow-unauthenticated

   메시지가 표시되면 예를 들어 europe-west1과 같은 리전을 선택합니다.

   MCP 서버는 공개적으로 액세스할 수 없으며 IAM을 통한 인증이 필요합니다.

5. Cloud Run에서 실행 중인 원격 MCP 서버에 사용자 ID를 사용하여 안전하게 연결하려면 로컬 머신에서 Cloud Run 프록시를 실행합니다.

   gcloud run services proxy cloud-run-mcp --port=3000 --region=REGION --project=PROJECT_ID

   이렇게 하면 포트 3000에 로컬 프록시가 생성되어 원격 MCP 서버로 요청을 전달하고 사용자 ID를 주입합니다.

6. MCP 클라이언트의 MCP 구성 파일을 다음과 같이 업데이트합니다.

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

   MCP 클라이언트가 url 속성을 지원하지 않는 경우 mcp-remote를 사용할 수 있습니다.

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