bq MCP

用于大查询的MCP服务器

目标

• Big Query中所述修改相应参数的值MCP Server构建

目的

1. 技术观点：MCP Server for BQ积聚
2. 团队观点：简化表格调查工作

Vertex AI启用

1. Vertex AI的，之API启用

2.应用程序默认凭据を取得

$ gcloud auth application-default login

MCP数据库工具箱

这个Toolbox表示AI Agent为了访问数据库tool提供，提供 tool什么是AI Agent中所述的工具，调整墙的布局和几何形状。 如以下所示Agent来定义自定义外观。

alt text

安装Mac工具箱

• 版本： 0.7.0

$ wget https://storage.googleapis.com/genai-toolbox/v0.7.0/darwin/arm64/toolbox
$ chmod +x toolbox

配置工具箱

• 指定数据源

  my-bigquery-source:
    kind: bigquery
    project: mcp-server-for-big-query
    location: US

• Agent可利用的tool提供

toolsets:
  my-toolset: # Toolset name
  - search-hotels-by-name
  - search-hotels-by-location

• 具体的tool定义

  search-hotels-by-name:
    kind: bigquery-sql
    source: my-bigquery-source # Source name
    description: Search for hotels based on name. # Description
    parameters: # Parameters for the SQL query
    - name: name
      type: string
      description: The name of the hotel.
    # 与えられたホテル名を用いた曖昧検索を行うSQL文
    statement: SELECT * FROM `sample.hotels` WHERE LOWER(name) LIKE LOWER(CONCAT('%', @name, '%'));

正在运行工具箱服务器

$ ./toolbox --tools-file tools.yml
2025-06-27T16:55:21.625816+09:00 INFO "Server ready to serve!" 
# localhost:5000 でToolbox Serverが起動します

• 动作确认

$ curl http://127.0.0.1:5000
🧰 Hello, World! 🧰%     

MCP服务器

以上设定Toolbox打开AI Agent连接到MCP Server构建。

toolbox = ToolboxSyncClient("http://127.0.0.1:5000")

Agent在…之上tools作为参数传递Toolbox可以利用。

tools = toolbox.load_toolset("my-toolset")

root_agent = Agent(
    ...,
    tools=tools,
)

.env for ADK

GOOGLE_GENAI_USE_VERTEXAI=TRUE # Vertex AIを使用する場合はTRUE
GOOGLE_CLOUD_PROJECT=GCP_PROJECT # Google CloudプロジェクトID
GOOGLE_CLOUD_LOCATION=global # Vertex AIのロケーション

正在运行MCP服务器

$ cd hotel_agent
$ adk web
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)

• 动作确认

在浏览器中localhost:8000访问，聊天hello输入 如果有什么反应的话OK

用于大查询的MCP服务器全体の動作確認

在浏览器中localhost:8000访问并输入以下内容

search for Comfort Inn Bern

如果你收到以下图像的响应OK

alt text

MCP Toolbox打开IDE协作

帆板运动

• 级联助手>MCP>配置MCP>查看原始配置

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

光标

.cursor/mcp.json

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

VSCode

.vscode/mcp.json

{
  "servers": {
    "bigquery": {
      "command": "toolbox",
      "args": [
        "--prebuilt",
        "bigquery",
        "--stdio"
      ],
      "env": {
        "BIGQUERY_PROJECT": "mcp-server-for-big-query"
      }
    }
  }
}

参考

• ADK 打开MCP Toolbox for Databases 使用BigQuery 代理开发-Zenn
• 使用MCP工具箱将IDE连接到BigQuery-谷歌云