AI导哈

BigQuery数据库查询服务器

一个提供BigQuery数据库访问的模型上下文协议服务器，支持数据库模式检查和查询执行。

  • by LucasHild
  • Python
  • 本地部署
  • 131 星标
  • 更新于
在 GitHub 查看 LucasHild/mcp-server-bigquery

使用说明

BigQuery MCP服务器

提供对BigQuery访问的模型上下文协议服务器。此服务器使LLM能够检查数据库模式并执行查询。

组件

工具

服务器实现了一个工具：

  • execute-query：使用BigQuery方言执行SQL查询
  • list-tables：列出BigQuery数据库中的所有表
  • describe-table：描述特定表的架构

配置

服务器可以配置命令行参数或环境变量。

参数 环境变量 必填 描述
--project BIGQUERY_PROJECT 是 GCP项目ID
--location BIGQUERY_LOCATION 是 GCP位置（例如。 europe-west9).
--dataset BIGQUERY_DATASETS 否 仅考虑特定的BigQuery数据集。通过重复参数可以指定多个数据集（例如。 --dataset my_dataset_1 --dataset my_dataset_2)或者在环境变量中用逗号将它们连接起来（例如。 BIGQUERY_DATASETS=my_dataset_1,my_dataset_2).如果没有提供，将考虑项目中的所有数据集。
--key-file BIGQUERY_KEY_FILE 否 BigQuery服务帐户密钥文件的路径。如果没有提供，服务器将使用默认凭据。
--timeout BIGQUERY_TIMEOUT 否 等待查询完成的最长时间（秒）。如果没有提供，查询将无限期等待。

安装

通过Smithery安装

通过以下方式自动安装BigQuery Server for Claude Desktop 铁匠铺:

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

克劳德代码

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

克劳德桌面版

在MacOS上： ~/Library/Application\ Support/Claude/claude_desktop_config.json
在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}}"
      }
    }
  }
}

光标

  1. 打开光标设置→ MCP
  2. 单击添加新的全局MCP服务器
  3. 按照以下模式为BigQuery MCP添加一个条目：
{
  "mcpServers": {
    "bigquery": {
      "command": "uvx",
      "args": ["mcp-server-bigquery"],
      "env": {
        "BIGQUERY_PROJECT": "{{GCP_PROJECT_ID}}",
        "BIGQUERY_LOCATION": "{{GCP_LOCATION}}"
      }
    }
  }
}

相关 MCP