Google 클라우드 MCP 서버

Google Cloud 리소스와 상호 작용하기 위한 컨텍스트와 도구를 제공하기 위해 Google Cloud 서비스에 연결하는 모델 컨텍스트 프로토콜 서버입니다.

서비스

지원되는 서비스:

[x] Google 클라우드 로깅
[x] Google 클라우드 모니터링
[x] 구글 클라우드 스패너

개발 중인 서버:

[ ] 구글 클라우드 추적
[ ] 구글 IAM
[ ] 구글 클라우드 컴퓨트
[ ] 구글 클라우드 런
[ ] 구글 클라우드 스토리지

Google 클라우드 로깅

Google Cloud Logging에서 로그 항목을 쿼리하고 필터링합니다.

사용자 정의 필터를 사용하여 로그 쿼리
특정 시간 범위 내의 로그 검색
읽을 수 있는 형식으로 로그 항목 형식 지정 및 표시

구글 클라우드 스패너

Google Cloud Spanner 데이터베이스와 상호 작용:

Spanner 데이터베이스에 대해 SQL 쿼리 실행
사용 가능한 데이터베이스 및 테이블 나열
데이터베이스 스키마 탐색

Google 클라우드 모니터링

Google Cloud Monitoring에서 메트릭을 검색하고 분석합니다.

사용자 정의 필터를 사용하여 메트릭 쿼리
시간 경과에 따른 메트릭 데이터 시각화
사용 가능한 메트릭 유형 나열

구글 클라우드 추적

Google Cloud Trace에서 분산된 추적을 분석합니다.

ID로 추적 검색
필터링 옵션을 사용하여 최근 추적 목록 나열
로그와 관련된 추적 찾기
실패한 추적 식별
자연어를 사용하여 추적을 쿼리합니다(예: "지난 1시간 동안 실패한 추적을 보여주세요").

입증

이 서버는 Google Cloud를 통한 두 가지 인증 방법을 지원합니다.

서비스 계정 키 파일 (권장): GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 키 파일 경로로 설정하세요. 이는 표준 Google Cloud 인증 방식입니다.
환경 변수 : GOOGLE_CLIENT_EMAIL 및 GOOGLE_PRIVATE_KEY 환경 변수를 직접 설정합니다. 이는 키 파일을 저장하는 것이 어려운 환경에서 유용합니다.

GOOGLE_CLOUD_PROJECT 환경 변수가 설정된 경우 서버는 이 변수를 사용하고, 그렇지 않은 경우 인증 자격 증명에서 프로젝트 ID를 확인하려고 시도합니다.

설치

지엑스피1

Google Cloud에 인증:

gcloud auth application-default login

클라이언트에서 mcpServers 구성하세요.

{
  "mcpServers": {
      "google-cloud-mcp": {
          "command": "node",
          "args": [
              "/Users/foo/code/google-cloud-mcp/dist/index.js"
          ],
          "env": {
              "GOOGLE_APPLICATION_CREDENTIALS": "/Users/foo/.config/gcloud/application_default_credentials.json"
          }
      }
  }
}

개발

서버 시작

# Build the project
pnpm build

# Start the server
pnpm start

개발 모드

# Build the project
pnpm build

# Start the server and inspector
npx -y @modelcontextprotocol/inspector node dist/index.js

Smithery와 함께 사용(곧)

이 서버는 Smithery와 함께 배포 및 사용할 수 있습니다. 이 서버는 인증 지연 로딩을 구현하여 즉시 시작되고 실제로 필요할 때까지 인증을 지연합니다. 작동에는 여전히 인증이 필요하지만, 이러한 접근 방식은 서버 초기화 중 시간 초과를 방지합니다.

참고: Smithery 로컬 서버 지원은 현재 개발 중이므로 아직 제공되지 않을 수 있습니다.

문제 해결

서버 시간 초과 문제

Smithery로 서버를 실행할 때 시간 초과 문제가 발생하면 다음을 시도해 보세요.

구성에서 debug: true 설정하여 디버그 로깅을 활성화하세요.
lazyAuth: true 실제로 필요할 때까지 인증을 연기하도록 설정되어 있는지 확인하세요.
자격 증명 파일이 접근 가능하고 유효한지 확인하세요.
오류 메시지가 있는지 로그를 확인하세요.

중요 : 작동에는 여전히 인증이 필요하지만, 지연 로딩이 활성화되어 있으면 서버가 즉시 시작되고 초기화 중이 아닌 필요할 때 인증됩니다.

인증 문제

서버는 두 가지 인증 방법을 지원합니다.

서비스 계정 키 파일 : GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 키 파일의 경로로 설정합니다.
환경 변수 : GOOGLE_CLIENT_EMAIL 및 GOOGLE_PRIVATE_KEY 환경 변수 설정

인증 문제가 있는 경우 다음을 확인하세요.

귀하의 서비스 계정에는 필요한 권한이 있습니다.
키 파일이 올바르게 포맷되어 접근 가능합니다.
환경 변수가 올바르게 설정되었습니다

Google Cloud MCP Server

Integrations