使用说明

项目简介

Choose MCP Server 允许 Claude Desktop Client 与 Google BigQuery 数据库进行交互。它提供了一系列工具，使 Claude 能够查询数据、获取表信息和访问文档，从而增强 Claude 处理 BigQuery 数据库的能力。

主要功能点

连接 Claude 与 BigQuery: 允许 Claude Desktop Client 连接到您的 Google BigQuery 项目。
数据查询工具: 提供工具用于列出 BigQuery 中的表、获取表结构信息、执行 SQL 查询以及获取当前时间。
文档加载: 支持从 DBT (Data Build Tool) 清单文件加载数据表的文档说明（可选）。

安装步骤

安装 Claude Desktop Client: 如果您还没有安装，请从 https://claude.ai/download 下载并安装 Claude Desktop Client。
安装 uv: 打开终端并运行命令 'brew install uv' 安装 uv 包管理器。
配置 MCP 服务器: 编辑 Claude Desktop Client 的配置文件 'claude_desktop_config.json' (通常位于 '~/Library/Application Support/Claude')，并将以下 JSON 配置添加到 'mcpServers' 部分。
配置 Google Cloud 凭据: 确保您已登录 Google Cloud 并配置了应用程序默认凭据 (ADC)。在终端中运行 'gcloud auth login --update-adc' 进行配置。
启动 Claude Desktop Client: 打开 Claude Desktop Client，即可开始使用 Choose MCP Server 与 BigQuery 互动。

服务器配置 (claude_desktop_config.json)

以下配置信息需要添加到 Claude Desktop Client 的 'claude_desktop_config.json' 文件中的 'mcpServers' 区域。

{
  "mcpServers": {
    "Choose MCP Server": {
      "command": "uvx",
      "args": ["choose-mcp-server"],
      "env": {
        "PROJECT_ID": "YOUR_PROJECT_ID", // 替换为您的 Google Cloud 项目 ID
        "DATASETS": "DATASET_1,DATASET_2,DATASET_3", // 替换为您要访问的 BigQuery 数据集名称，多个数据集用逗号分隔
        "DBT_MANIFEST_FILEPATH": "YOUR_DBT_MANIFEST_FILEPATH" // 可选：DBT 清单文件路径，用于加载表文档
      }
    }
  }
}

配置参数说明:

'command': MCP 服务器的启动命令，这里设置为 'uvx'，表示使用 uv 包管理器运行。
'args': 传递给启动命令的参数，这里设置为 'choose-mcp-server'，对应项目仓库的入口脚本。
'env': 环境变量配置，包含以下参数：
- 'PROJECT_ID': 您的 Google Cloud 项目 ID，用于访问 BigQuery。请务必替换为您的实际项目 ID。
- 'DATASETS': 您希望 Claude 能够访问的 BigQuery 数据集列表，用逗号分隔。请替换为您要访问的数据集名称。
- 'DBT_MANIFEST_FILEPATH': (可选) DBT 清单文件的路径。如果配置，服务器将加载 DBT 清单以提供更详细的表文档。

基本使用方法

配置完成后，在 Claude Desktop Client 中，您可以直接向 Claude 提问关于 BigQuery 数据的问题。Claude 将会利用 Choose MCP Server 提供的工具来查询 BigQuery，并返回结果。例如，您可以询问 "Show me the schema of table X in dataset Y" 或 "Query table Z to get the latest sales data"。Claude 将自动调用相应的工具来完成您的请求。

关键词