项目简介

Snow Leopard BigQuery MCP服务器是一个基于Model Context Protocol (MCP) 标准的应用，它充当AI代理与Google BigQuery数据库之间的桥梁。通过这个服务器，AI代理可以使用自然语言查询BigQuery数据库、探索数据表结构，从而无需直接编写SQL代码即可获取和分析数据。

主要功能点

• 资源托管与访问
  • 'bigquery://tables': 列出AI代理可用的所有BigQuery数据表。
  • 'bigquery://tables/{table}/schema': 获取指定数据表的详细模式（schema）信息。
• 工具注册与执行
  • 'list_tables()': 列出所有可用的BigQuery数据表。
  • 'get_schema(table: str)': 获取给定数据表的模式定义。
  • 'query(sql: str)': 执行标准的BigQuery SQL查询语句，并返回查询结果。

安装步骤

在开始之前，请确保您的系统已安装以下工具：

• Claude Desktop (或其他兼容MCP协议的AI客户端)
• Google Cloud Project 并已启用BigQuery服务
• Google Cloud CLI (gcloud)
• UV 包管理器 (推荐，用于Python环境管理)

1. 认证Google Cloud: 在终端中运行以下命令，完成Google Cloud的认证过程。这将打开浏览器引导您登录并授权。

   gcloud auth application-default login
   

2. 安装Snow Leopard BigQuery MCP: 使用'uv'包管理器安装'sl-bigquery-mcp'。

   uv pip install sl-bigquery-mcp
   

   如果您还没有安装'uv'，请按照uv安装指南进行安装。

服务器配置

您的MCP客户端（例如Claude Desktop）需要配置如何启动BigQuery MCP服务器。您需要在客户端的配置文件中添加一个新的MCP服务器条目。

以Claude Desktop为例，打开 'claude_desktop_config.json' 文件（Mac用户路径通常在 '~/Library/Application Support/Claude/claude_desktop_config.json'，Windows用户在 '%APPDATA%\Claude\claude_desktop_config.json'），并在 'mcpServers' 部分添加以下信息。

• 服务器名称 (Name): 您可以在客户端中为此MCP服务器指定一个名称，例如 'bigquery'。
• 启动命令 (Command): 通常是 'uvx'，这是一个用于运行Python工具的命令。如果 'uvx' 不在系统的环境变量中，您可能需要提供其完整路径（例如，通过运行 'which uvx' 找到路径）。
• 启动参数 (Arguments): 这些参数告诉服务器要连接哪个BigQuery数据。
  • 'sl-bigquery-mcp': 这是启动BigQuery MCP服务器的核心程序。
  • '--dataset <您的数据集名称>': 指定要公开给AI代理的BigQuery数据集。例如，'bigquery-public-data.usa_names'。您可以指定多个数据集。
  • '--project <您的Google Cloud项目ID>': 指定您有权访问的Google Cloud项目ID。请务必将占位符 '<您的Google Cloud项目ID>' 替换为您的实际项目ID。

配置完成后，请保存文件并重启您的MCP客户端（例如，完全关闭Claude Desktop再重新打开）。如果客户端是从GUI启动的，可能无法访问'uvx'。在这种情况下，请尝试从终端启动客户端（例如，在Mac上运行 'open -a claude'）。

基本使用方法

配置并启动服务器后，您就可以在MCP客户端中向AI代理提问有关BigQuery数据的问题了。AI代理将通过MCP服务器执行查询和获取模式信息。

示例查询：

What are the top 10 most popular names in 2020? (2020年最受欢迎的10个名字是什么？)

AI代理将解析此请求，调用MCP服务器的 'query' 工具，执行相应的BigQuery SQL语句并返回结果。