remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Supports containerization of the MCP server for deployment to Google Cloud Run, with the deployment script handling Docker container building and pushing to Google Container Registry.
Enables hosting an MCP server on Google Cloud Run with IAM authentication, allowing teams to securely access the server over the internet using Cloud SDK for authentication and proxy connections.
Google Cloud Run에서 MCP SSE 서버 호스팅
현재(2024년 3월 4일) MCP는 인증 및 권한 부여 문제를 해결하고 있습니다. 2025년 상반기에 완료할 계획입니다. 문제는 지금 당장 팀원들과 MCP 서버를 공유하고 싶다는 것입니다. 그래서 이렇게 되었습니다. 현재 Cursor 등에서 SSE MCP 서버를 사용하는 유일한 즉각적인 해결책은 네트워크 계층 기반 솔루션(예: 프록시)입니다. 기본 인증, API 키 등은 신경 쓰지 마세요.
GCP Cloud Run과 사용자 기반 IAM 인증을 활용하여 클라이언트가 인터넷을 통해 사용자 지정 MCP 서버에 액세스할 수 있는 간단하고 안전한 방법을 만들었습니다.
작동 원리
MCP 서버는 Google Cloud Run에 호스팅됩니다. Cloud Run IAM 인증을 활용하면 Google Cloud SDK를 사용하여 프록시 연결을 생성하여 인터넷에서 서버에 안전하게 연결할 수 있습니다.
TLDR README
이미 로컬에 docker와 gcloud CLI를 설정한 경우 최소한의 구성으로 바로 작동해야 합니다 .
1단계: 프로젝트 ID, 서비스 계정 이메일 등으로 deploy.sh 업데이트합니다.
2단계: 배포가 성공하면 제공된 클라우드 실행 URL을 가져와 프로젝트 ID와 함께 mcp_proxy.ts 에 추가합니다.
3단계: 프록시 npx ts-node mcp_proxy.ts 실행합니다.
3단계: http://localhost:3030을 사용하여 MCP 서버에 액세스합니다. 설정 > 기능 > MCP 서버에서 커서에 추가합니다(명령이 아닌 SSE를 선택했는지 확인하세요).
길고 지루한 README
배포 단계
- 저장소를 복제합니다
npm install실행하여 종속성을 설치합니다.npm run dev실행하여 로컬에서 서버를 시작합니다.
Google Cloud Run에 배포
Google Cloud Run에 MCP 서버를 배포하려면:
- Google Cloud SDK가 설치되어 있는지 확인하세요.
- 프로젝트 세부정보로
deploy.sh스크립트를 업데이트하세요.PROJECT_ID: Google Cloud 프로젝트 IDREGION: 선호하는 GCP 지역SERVICE_ACCOUNT_EMAIL: 적절한 권한이 있는 서비스 계정 이메일
- 배포 스크립트를 실행합니다.지엑스피1
배포 스크립트는 다음과 같습니다.
- MCP 서버용 Docker 컨테이너 빌드
- Google Container Registry에 푸시하세요
- 인증이 활성화된 상태로 Cloud Run에 배포
배포된 MCP 서버에 연결
배포된 MCP 서버에 연결하려면:
- MCP 프록시를 로컬로 실행합니다.Copy
- 프록시는 다음을 수행합니다.
- Google Cloud에 인증되었는지 확인하세요
- 자동으로 인증 토큰을 얻습니다
- 로컬 프록시 서버를 생성합니다(기본값: http://localhost:3030 )
- 인증된 요청을 Cloud Run 서비스로 전달합니다.
- 로컬 프록시 URL에 연결하도록 MCP 클라이언트를 구성하세요.
커서에서 MCP 서버 사용
- 먼저, 프록시를 실행하여 로컬 머신과 Google Cloud Run에 호스팅된 MCP 서버 간의 연결을 설정해 보겠습니다.
- 이제 MCP 서버 섹션의 설정 > 기능 탭에서 커서에 로컬 프록시 서버를 추가해 보겠습니다.
- 이제 준비가 되었습니다! 새 Composer를 시작하고(에이전트 모드인지 확인하세요) 해당 지역의 날씨를 물어보세요. 프록시가 연결된 터미널의 출력과 Composer의 출력은 다음과 같습니다.
보안
이러한 설정은 여러 가지 보안 이점을 제공합니다.
- 귀하의 MCP 서버는 인증 없이는 공개적으로 접근할 수 없습니다.
- 모든 연결은 Google Cloud IAM으로 보호됩니다.
- 팀 구성원은 연결하려면 Google Cloud SDK 액세스 권한이 필요합니다.
연결 문제
mcp_proxy.ts의 Cloud Run URL이 배포된 서비스와 일치하는지 확인하세요.- 서버 측 오류가 있는지 Cloud Run 로그를 확인하세요.
기여하다
기여를 환영합니다! 이슈를 제출하거나 풀 리퀘스트를 보내주세요.
특허
This server cannot be installed
Google Cloud Run에 호스팅된 보안 MCP(Model Context Protocol) 서버는 Google Cloud IAM을 통해 인증된 액세스를 제공하여 팀 협업을 지원하고, 공식 MCP 인증이 구현되기 전에 팀이 인터넷을 통해 사용자 지정 MCP 서버를 공유할 수 있도록 합니다.