BigQuery MCP-Server

Ein Model Context Protocol-Server, der Zugriff auf BigQuery bietet. Dieser Server ermöglicht LLMs die Überprüfung von Datenbankschemata und die Ausführung von Abfragen.

Komponenten

Werkzeuge

Der Server implementiert ein Tool:

• execute-query : Führt eine SQL-Abfrage im BigQuery-Dialekt aus

• list-tables : Listet alle Tabellen in der BigQuery-Datenbank auf

• describe-table : Beschreibt das Schema einer bestimmten Tabelle

Related MCP server: MCP Database Server

Konfiguration

Der Server kann entweder mit Befehlszeilenargumenten oder Umgebungsvariablen konfiguriert werden.

Schnellstart

Installieren

Installation über Smithery

So installieren Sie BigQuery Server für Claude Desktop automatisch über Smithery :

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

Claude Desktop

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

Konfiguration von Entwicklungs-/unveröffentlichten Servern

"mcpServers": {
  "bigquery": {
    "command": "uv",
    "args": [
      "--directory",
      "{{PATH_TO_REPO}}",
      "run",
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

Konfiguration veröffentlichter Server

"mcpServers": {
  "bigquery": {
    "command": "uvx",
    "args": [
      "mcp-server-bigquery",
      "--project",
      "{{GCP_PROJECT_ID}}",
      "--location",
      "{{GCP_LOCATION}}"
    ]
  }
}

Ersetzen Sie {{PATH_TO_REPO}} , {{GCP_PROJECT_ID}} und {{GCP_LOCATION}} durch die entsprechenden Werte.

Entwicklung

Erstellen und Veröffentlichen

So bereiten Sie das Paket für die Verteilung vor:

1. Erhöhen Sie die Versionsnummer in pyproject.toml

2. Abhängigkeiten synchronisieren und Sperrdatei aktualisieren:

uv sync

3. Erstellen Sie Paketverteilungen:

uv build

Dadurch werden Quell- und Wheel-Distributionen im Verzeichnis dist/ erstellt.

4. Auf PyPI veröffentlichen:

uv publish

Hinweis: Sie müssen PyPI-Anmeldeinformationen über Umgebungsvariablen oder Befehlsflags festlegen:

• Token: --token oder UV_PUBLISH_TOKEN

• Oder Benutzername/Passwort: --username / UV_PUBLISH_USERNAME und --password / UV_PUBLISH_PASSWORD

Debuggen

Da MCP-Server über stdio laufen, kann das Debuggen eine Herausforderung darstellen. Für ein optimales Debugging empfehlen wir dringend die Verwendung des MCP Inspector .

Sie können den MCP Inspector über npm mit diesem Befehl starten:

npx @modelcontextprotocol/inspector uv --directory {{PATH_TO_REPO}} run mcp-server-bigquery

Beim Start zeigt der Inspector eine URL an, auf die Sie in Ihrem Browser zugreifen können, um mit dem Debuggen zu beginnen.