Connetti il tuo IDE a BigQuery utilizzando MCP Toolbox

Questa guida mostra come utilizzare MCP Toolbox for Databases per connettere l'istanza BigQuery a una serie di ambienti di sviluppo integrati (IDE) e strumenti per sviluppatori. Utilizza il Model Context Protocol (MCP), un protocollo aperto per connettere modelli linguistici di grandi dimensioni (LLM) a origini dati come BigQuery, consentendoti di eseguire query SQL e interagire con il tuo progetto direttamente dagli strumenti esistenti.

Questa guida mostra la procedura di connessione per i seguenti IDE:

• Cursore
• Windsurf (in precedenza Codeium)
• Visual Studio Code (Copilot)
• Cline (estensione VS Code)
• Claude desktop
• Claude code

Prima di iniziare

1. Nella console Trusted Cloud , nella pagina del selettore di progetti, seleziona o crea un progetto Trusted Cloud by S3NS .

2. Assicurati che la fatturazione sia attivata per il tuo progetto Trusted Cloud by S3NS .

3. Abilita l'API BigQuery nel Trusted Cloud by S3NS progetto.

4. Configura i ruoli e le autorizzazioni richiesti per completare questa attività. Per connetterti all'istanza, devi disporre del ruolo Utente BigQuery (roles/bigquery.user), del ruolo Visualizzatore dati BigQuery (roles/bigquery.dataViewer) o di autorizzazioni IAM equivalenti.

5. Configura le credenziali predefinite dell'applicazione (ADC) per il tuo ambiente.

Installare la casella degli strumenti MCP

1. Scarica l'ultima versione di MCP Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e all'architettura della CPU. Devi utilizzare MCP Toolbox versione V0.7.0 o successive:

   linux/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/linux/amd64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.7.0.

   macOS darwin/arm64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/arm64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.7.0.

   macOS darwin/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/darwin/amd64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.7.0.

   windows/amd64

   curl -O https://storage.googleapis.com/genai-toolbox/VERSION/windows/amd64/toolbox
   

   Sostituisci VERSION con la versione di MCP Toolbox, ad esempio v0.7.0.

2. Rendi eseguibile il file binario:

   chmod +x toolbox
   

3. Verifica l'installazione:

   ./toolbox --version
   

Configura il client MCP

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

{
  "servers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

{
  "mcpServers": {
    "bigquery": {
      "command": "./PATH/TO/toolbox",
      "args": ["--prebuilt","bigquery","--stdio"],
      "env": {
        "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

Utilizzare gli strumenti

Il tuo strumento di AI è ora connesso a BigQuery tramite MCP. Prova a chiedere all'assistente AI di elencare le tabelle, creare una tabella o definire ed eseguire altre istruzioni SQL.

Sono disponibili i seguenti strumenti per il LLM:

• execute_sql: esegui l'istruzione SQL
• get_dataset_info: recupera i metadati del set di dati
• get_table_info: recupera i metadati della tabella
• list_dataset_ids: elenca i set di dati
• list_table_ids: elenca le tabelle