지씨피 엠씨피
Claude와 같은 AI 비서가 Google Cloud Platform 환경과 상호 작용할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 대화 중에 GCP 리소스에 대한 자연어 쿼리 및 관리가 가능합니다.
특징
🔍 자연어를 사용하여 GCP 리소스 쿼리 및 수정
☁️ 여러 GCP 프로젝트 지원
🌐 다중 지역 지원
🔐 안전한 자격 증명 처리(자격 증명이 외부 서비스에 노출되지 않음)
🏃♂️ GCP 자격 증명을 사용한 로컬 실행
🔄 향상된 안정성을 위한 자동 재시도
Related MCP server: MCP Gemini Server
필수 조건
노드.js
클로드 데스크탑/커서/윈드서프
로컬로 구성된 GCP 자격 증명(애플리케이션 기본 자격 증명)
설치
저장소를 복제합니다.
지엑스피1
종속성 설치:
구성
클로드 데스크탑
Claude 데스크톱 앱을 열고 설정 -> 개발자 -> 구성 편집으로 이동합니다.
claude_desktop_config.json에 다음 항목을 추가하세요.
npm을 통해:
소스에서 설치한 경우:
소스 설치를 사용하는 경우 /path/to/gcp-mcp 프로젝트 디렉토리의 실제 경로로 바꾸세요.
커서
커서를 열고 설정(⌘,)으로 이동합니다.
AI -> 모델 컨텍스트 프로토콜로 이동합니다.
새로운 MCP 구성을 추가합니다.
윈드서핑
~/.windsurf/config.json엽니다(존재하지 않으면 만듭니다)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 항목을 가져옵니다.
예시 상호작용
사용 가능한 프로젝트 나열:
프로젝트를 선택하세요:
청구 상태 확인:
로그 보기:
지원 서비스
구글 컴퓨트 엔진
클라우드 스토리지
클라우드 기능
클라우드 런
빅쿼리
클라우드 SQL
Google Kubernetes 엔진(GKE)
클라우드 로깅
클라우드 청구
리소스 관리자
곧 더 많은 내용이 나올 예정입니다...
문제 해결
로그를 보려면:
일반적인 문제:
인증 오류:
gcloud auth application-default login실행했는지 확인하세요.권한 오류: 계정의 IAM 역할을 확인하세요
API 오류: 프로젝트에서 필수 API가 활성화되어 있는지 확인하세요.
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
MIT