BigQuery

Servidor MCP do BigQuery

Um servidor Model Context Protocol que fornece acesso ao BigQuery. Este servidor permite que LLMs inspecionem esquemas de banco de dados e executem consultas.

Componentes

Ferramentas

O servidor implementa uma ferramenta:

• execute-query: Executa uma consulta SQL usando o dialeto do BigQuery
• list-tables: Lista todas as tabelas no banco de dados BigQuery
• describe-table: Descreve o esquema de uma tabela específica

Configuração

O servidor pode ser configurado com argumentos de linha de comando ou variáveis de ambiente.

Argumento	Variável de Ambiente	Obrigatório	Descrição
--project	BIGQUERY_PROJECT	Sim	O ID do projeto GCP.
--location	BIGQUERY_LOCATION	Sim	A localização GCP (por exemplo, europe-west9).
--dataset	BIGQUERY_DATASETS	Não	Considere apenas conjuntos de dados específicos do BigQuery. Vários conjuntos de dados podem ser especificados repetindo o argumento (por exemplo, --dataset my_dataset_1 --dataset my_dataset_2) ou unindo-os com vírgula na variável de ambiente (por exemplo, BIGQUERY_DATASETS=my_dataset_1,my_dataset_2). Se não for fornecido, todos os conjuntos de dados do projeto serão considerados.
--key-file	BIGQUERY_KEY_FILE	Não	Caminho para um arquivo de chave de conta de serviço para o BigQuery. Se não for fornecido, o servidor usará as credenciais padrão.
--timeout	BIGQUERY_TIMEOUT	Não	Tempo máximo em segundos para aguardar a conclusão de uma consulta. Se não for fornecido, as consultas aguardarão indefinidamente.

Instalação

Instalação via Smithery

Para instalar o BigQuery Server para Claude Desktop automaticamente via Smithery:

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

No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
No Windows: %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. Abra Configurações do Cursor → MCP
2. Clique em Adicionar novo servidor MCP global
3. Adicione uma entrada para o MCP do BigQuery, seguindo o padrão abaixo:

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