BigQuery MCP sunucusu

BigQuery'ye erişim sağlayan bir Model Context Protocol sunucusu. Bu sunucu, LLM'lerin veritabanı şemalarını incelemesine ve sorguları yürütmesine olanak tanır.

Bileşenler

Araçlar

Sunucu bir araç uygular:

• execute-query: BigQuery dilimi kullanarak bir SQL sorgusu yürütür
• list-tables: BigQuery veritabanındaki tüm tabloları listeler
• describe-table: Belirli bir tablonun şemasını açıklar

Yapılandırma

Sunucu, komut satırı argümanları veya ortam değişkenleri ile yapılandırılabilir.

Argüman	Ortam Değişkeni	Gerekli	Açıklama
--project	BIGQUERY_PROJECT	Evet	GCP proje kimliği.
--location	BIGQUERY_LOCATION	Evet	GCP konumu (ör. europe-west9).
--dataset	BIGQUERY_DATASETS	Hayır	Yalnızca belirli BigQuery veri setlerini dikkate alır. Argümanı tekrarlanarak (ör. --dataset my_dataset_1 --dataset my_dataset_2) veya ortam değişkeninde virgülle birleştirerek (ör. BIGQUERY_DATASETS=my_dataset_1,my_dataset_2) birden fazla veri seti belirtilebilir. Sağlanmazsa, projede bulunan tüm veri setleri dikkate alınır.
--key-file	BIGQUERY_KEY_FILE	Hayır	BigQuery için bir hizmet hesabı anahtar dosyasının yolu. Sağlanmazsa, sunucu varsayılan kimlik bilgilerini kullanır.
--timeout	BIGQUERY_TIMEOUT	Hayır	Bir sorgunun tamamlanmasını beklemek için maksimum süre (saniye cinsinden). Sağlanmazsa, sorgular belirsiz şekilde bekler.

Kurulum

Smithery ile Kurulum

BigQuery Sunucusunu Claude Desktop'a Smithery üzerinden otomatik olarak yüklemek için:

npx -y @smithery/cli install mcp-server-bigquery --client claude

Claude Code

claude mcp add bigquery --scope user --transport stdio -- uvx mcp-server-bigquery --project {PROJECT_ID} --location {{LOCATION}}

Claude Desktop

MacOS'ta: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows'ta: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bigquery": {
      "command": "uvx",
      "args": ["mcp-server-bigquery"],
      "env": {
        "BIGQUERY_PROJECT": "{{GCP_PROJECT_ID}}",
        "BIGQUERY_LOCATION": "{{GCP_LOCATION}}"
      }
    }
  }
}

Cursor

1. Cursor Ayarları → MCP'yi açın
2. Yeni genel MCP sunucusu ekle'ye tıklayın
3. Aşağıdaki deseni izleyerek BigQuery MCP için bir giriş ekleyin:

{
  "mcpServers": {
    "bigquery": {
      "command": "uvx",
      "args": ["mcp-server-bigquery"],
      "env": {
        "BIGQUERY_PROJECT": "{{GCP_PROJECT_ID}}",
        "BIGQUERY_LOCATION": "{{GCP_LOCATION}}"
      }
    }
  }
}