GCP MCP

지씨피 엠씨피

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

특징

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

필수 조건

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

설치

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

구성

클로드 데스크탑

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

npm을 통해:

소스에서 설치한 경우:

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

커서

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

윈드서핑

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

GCP 설정

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

용법

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

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

사용 가능한 도구

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

예시 상호작용

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

2. 프로젝트를 선택하세요:

3. 청구 상태 확인:

4. 로그 보기:

지원 서비스

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

문제 해결

로그를 보려면:

일반적인 문제:

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

기여하다

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

특허

MIT