local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables querying and management of Google Cloud Platform resources including Compute Engine, Cloud Storage, Cloud Functions, Cloud Run, BigQuery, Cloud SQL, GKE, Cloud Logging, Cloud Billing and Resource Manager using natural language.
Provides tools for listing and managing Google Kubernetes Engine (GKE) clusters across different regions.

지씨피 엠씨피

Claude와 같은 AI 비서가 Google Cloud Platform 환경과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 대화 중에 GCP 리소스에 대한 자연어 쿼리 및 관리가 가능합니다.

특징

🔍 자연어를 사용하여 GCP 리소스 쿼리 및 수정
☁️ 여러 GCP 프로젝트 지원
🌐 다중 지역 지원
🔐 안전한 자격 증명 처리(자격 증명이 외부 서비스에 노출되지 않음)
🏃‍♂️ GCP 자격 증명을 사용한 로컬 실행
🔄 향상된 안정성을 위한 자동 재시도

필수 조건

노드.js
클로드 데스크탑/커서/윈드서프
로컬로 구성된 GCP 자격 증명(애플리케이션 기본 자격 증명)

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

구성

클로드 데스크탑

Claude 데스크톱 앱을 열고 설정 -> 개발자 -> 구성 편집으로 이동합니다.
claude_desktop_config.json 에 다음 항목을 추가하세요.

npm을 통해:

{
  "mcpServers": {
    "gcp": {
      "command": "sh",
      "args": ["-c", "npx -y gcp-mcp"]
    }
  }
}

소스에서 설치한 경우:

{
  "mcpServers": {
    "gcp": {
      "command": "npm",
      "args": [
        "--silent",
        "--prefix",
        "/path/to/gcp-mcp",
        "start"
      ]
    }
  }
}

소스 설치를 사용하는 경우 /path/to/gcp-mcp 프로젝트 디렉토리의 실제 경로로 바꾸세요.

커서

커서를 열고 설정(⌘,)으로 이동합니다.
AI -> 모델 컨텍스트 프로토콜로 이동합니다.
새로운 MCP 구성을 추가합니다.

{
  "gcp": {
    "command": "npx -y gcp-mcp"
  }
}

윈드서핑

~/.windsurf/config.json 엽니다(존재하지 않으면 만듭니다)
MCP 구성을 추가합니다.

{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-mcp"
    }
  }
}

GCP 설정

GCP 자격 증명을 설정하세요.
- gcloud auth application-default login 사용하여 애플리케이션 기본 자격 증명을 설정합니다.
AI 어시스턴트(Claude Desktop/Cursor/Windsurf)를 새로 고침하세요.

용법

먼저 프로젝트를 선택하거나 다음과 같은 질문을 해보세요.

"내가 액세스할 수 있는 모든 GCP 프로젝트 나열"
"프로젝트 X의 모든 Cloud SQL 인스턴스를 보여주세요"
"현재 내 청구 상태는 어떻습니까?"
"내 Cloud Run 서비스의 로그를 보여주세요"
"us-central1에 있는 모든 GKE 클러스터를 나열하세요"
"프로젝트 X의 모든 Cloud Storage 버킷을 보여주세요"
"us-central1에 어떤 Cloud Functions가 배포되어 있나요?"
"모든 Cloud Run 서비스 나열"
"BigQuery 데이터 세트와 테이블을 보여주세요"

사용 가능한 도구

run-gcp-code : TypeScript 코드를 사용하여 GCP API 호출을 실행합니다.
list-projects : 접근 가능한 모든 GCP 프로젝트 나열
select-project : 후속 작업을 위한 GCP 프로젝트를 선택합니다.
get-billing-info : 현재 프로젝트에 대한 청구 정보를 가져옵니다.
get-cost-forecast : 현재 프로젝트에 대한 비용 예측을 가져옵니다.
get-billing-budget : 현재 프로젝트의 청구 예산을 가져옵니다.
list-gke-clusters : 현재 프로젝트의 모든 GKE 클러스터를 나열합니다.
list-sql-instances : 현재 프로젝트의 모든 Cloud SQL 인스턴스를 나열합니다.
get-logs : 현재 프로젝트에 대한 Cloud Logging 항목을 가져옵니다.

예시 상호작용

사용 가능한 프로젝트 나열:

List all GCP projects I have access to

프로젝트를 선택하세요:

Use project my-project-id

청구 상태 확인:

What's my current billing status?

로그 보기:

Show me the last 10 log entries from my project

지원 서비스

구글 컴퓨트 엔진
클라우드 스토리지
클라우드 기능
클라우드 런
빅쿼리
클라우드 SQL
Google Kubernetes 엔진(GKE)
클라우드 로깅
클라우드 청구
리소스 관리자
곧 더 많은 내용이 나올 예정입니다...

문제 해결

로그를 보려면:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-gcp.log

일반적인 문제:

인증 오류: gcloud auth application-default login 실행했는지 확인하세요.
권한 오류: 계정의 IAM 역할을 확인하세요
API 오류: 프로젝트에서 필수 API가 활성화되어 있는지 확인하세요.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

MIT

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Claude와 같은 AI 도우미가 자연어를 통해 Google Cloud Platform 환경과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버로, 사용자는 대화 중에 GCP 리소스를 쿼리하고 관리할 수 있습니다.

Related Resources

Reddit Discussion about this server

GCP MCP