지씨피 엠씨피

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

특징

• 🔍 자연어를 사용하여 GCP 리소스 쿼리 및 수정

• ☁️ 여러 GCP 프로젝트 지원

• 🌐 다중 지역 지원

• 🔐 안전한 자격 증명 처리(자격 증명이 외부 서비스에 노출되지 않음)

• 🏃‍♂️ GCP 자격 증명을 사용한 로컬 실행

• 🔄 향상된 안정성을 위한 자동 재시도

Related MCP server: Kubectl MCP Tool

필수 조건

• 노드.js

• 클로드 데스크탑/커서/윈드서프

• 로컬로 구성된 GCP 자격 증명(애플리케이션 기본 자격 증명)

설치

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

지엑스피1

2. 종속성 설치:

npm install

구성

클로드 데스크탑

1. Claude 데스크톱 앱을 열고 설정 -> 개발자 -> 구성 편집으로 이동합니다.

2. 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 프로젝트 디렉토리의 실제 경로로 바꾸세요.

커서

1. 커서를 열고 설정(⌘,)으로 이동합니다.

2. AI -> 모델 컨텍스트 프로토콜로 이동합니다.

3. 새로운 MCP 구성을 추가합니다.

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

윈드서핑

1. ~/.windsurf/config.json 엽니다(존재하지 않으면 만듭니다)

2. MCP 구성을 추가합니다.

{
  "mcpServers": {
    "gcp": {
      "command": "npx -y gcp-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. 사용 가능한 프로젝트 나열:

List all GCP projects I have access to

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

Use project my-project-id

3. 청구 상태 확인:

What's my current billing status?

4. 로그 보기:

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

일반적인 문제:

1. 인증 오류: gcloud auth application-default login 실행했는지 확인하세요.

2. 권한 오류: 계정의 IAM 역할을 확인하세요

3. API 오류: 프로젝트에서 필수 API가 활성화되어 있는지 확인하세요.

기여하다

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

특허

MIT