BigQuery MCP Server

BigQuery MCP 서버

이게 뭐예요? 🤔

이 서버는 클로드와 같은 LLM이 BigQuery 데이터와 직접 소통할 수 있도록 해줍니다! AI 비서와 데이터베이스 사이에 위치하여 안전하고 효율적으로 소통할 수 있도록 도와주는 친절한 통역가라고 생각하면 됩니다.

빠른 예

지엑스피1

더 이상 SQL 쿼리를 직접 작성할 필요가 없습니다. 자연스럽게 데이터와 대화하세요!

어떻게 작동하나요? 🛠️

이 서버는 AI-데이터베이스 통신을 위한 범용 번역기인 모델 컨텍스트 프로토콜(MCP)을 사용합니다. MCP는 모든 AI 모델과 호환되도록 설계되었지만, 현재 Claude Desktop에서 개발자 프리뷰로 제공됩니다.

필요한 작업은 다음과 같습니다.

1. 인증 설정(아래 참조)
2. Claude Desktop의 구성 파일에 프로젝트 세부 정보를 추가하세요.
3. 자연스럽게 BigQuery 데이터와 채팅을 시작하세요!

무엇을 할 수 있나요? 📊

• 평범한 영어로 질문만 하면 SQL 쿼리를 실행할 수 있습니다.
• 데이터 세트에서 테이블과 구체화된 뷰에 모두 액세스하세요
• 리소스 유형(테이블 대 뷰)에 대한 명확한 레이블을 지정하여 데이터 세트 스키마를 탐색합니다.
• 안전한 한도 내에서 데이터를 분석합니다(기본적으로 1GB 쿼리 한도).
• 데이터를 안전하게 보호하세요(읽기 전용 액세스)

빠른 시작 🚀

필수 조건

• Node.js 14 이상
• BigQuery가 활성화된 Google Cloud 프로젝트
• Google Cloud CLI가 설치되어 있거나 서비스 계정 키 파일이 있습니다.
• Claude Desktop(현재 지원되는 유일한 LLM 인터페이스)

옵션 1: Smithery를 통한 빠른 설치(권장)

Smithery를 통해 Claude Desktop용 BigQuery MCP Server를 자동으로 설치하려면 터미널에서 다음 명령을 실행하세요.

설치 프로그램에서 다음 사항을 묻습니다.

• Google Cloud 프로젝트 ID
• BigQuery 위치(기본값은 us-central1)

Smithery는 구성이 완료되면 Claude Desktop 구성을 자동으로 업데이트하고 애플리케이션을 다시 시작합니다.

옵션 2: 수동 설정

수동 구성을 선호하거나 더 많은 제어가 필요한 경우:

1. Google Cloud로 인증 (방법 하나 선택):
   • Google Cloud CLI 사용(개발에 적합):
     gcloud auth application-default login
   • 서비스 계정 사용(프로덕션에 권장):
     # Save your service account key file and use --key-file parameter # Remember to keep your service account key file secure and never commit it to version control
2. Claude Desktop 구성에 추가 claude_desktop_config.json 에 다음을 추가하세요.
   • 기본 구성:
     { "mcpServers": { "bigquery": { "command": "npx", "args": [ "-y", "@ergut/mcp-bigquery-server", "--project-id", "your-project-id", "--location", "us-central1" ] } } }
   • 서비스 계정으로:
     { "mcpServers": { "bigquery": { "command": "npx", "args": [ "-y", "@ergut/mcp-bigquery-server", "--project-id", "your-project-id", "--location", "us-central1", "--key-file", "/path/to/service-account-key.json" ] } } }
3. 채팅을 시작하세요! Claude Desktop을 열고 데이터에 대해 질문해 보세요.

명령줄 인수

서버는 다음 인수를 허용합니다.

• --project-id : (필수) Google Cloud 프로젝트 ID
• --location : (선택 사항) BigQuery 위치, 기본값은 'us-central1'입니다.
• --key-file : (선택 사항) 서비스 계정 키 JSON 파일 경로

서비스 계정을 사용한 예:

필요한 권한

다음 중 하나가 필요합니다.

• roles/bigquery.user (권장)
• 또는 둘 다:
  • roles/bigquery.dataViewer
  • roles/bigquery.jobUser

개발자 설정(선택 사항) 🔧

맞춤 설정이나 기여를 원하시나요? 로컬에서 설정하는 방법은 다음과 같습니다.

그런 다음 Claude Desktop 구성을 업데이트하여 로컬 빌드를 가리키도록 합니다.

현재 제한 사항 ⚠️

• MCP 지원은 현재 Claude Desktop(개발자 미리보기)에서만 사용할 수 있습니다.
• 연결은 동일한 컴퓨터에서 실행되는 로컬 MCP 서버로 제한됩니다.
• 쿼리는 1GB 처리 제한이 있는 읽기 전용입니다.
• 테이블과 뷰가 모두 지원되지만 일부 복잡한 뷰 유형에는 제한이 있을 수 있습니다.

지원 및 리소스 💬

• 🐛 문제 보고
• 💡 기능 요청
• 📖 문서

라이센스 📝

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

저자 ✍️

살리흐 에르귀트

후원

이 프로젝트는 다음의 후원을 받고 있습니다:

버전 기록 📋

업데이트 및 버전 기록은 CHANGELOG.md를 참조하세요.