快速入门

前置条件

• 安装 Node.js (v16 或更高)
• 配置 Google Cloud 身份验证（gcloud CLI 或服务账号）

安装依赖

运行以下命令安装项目依赖： npm install

构建项目

运行以下命令构建项目： npm run build

开发模式

在开发时可以使用自动重建模式： npm run watch

运行服务器

完成构建后，通过以下命令运行服务器： node /path/to/build/index.js

调试支持

推荐使用 MCP Inspector 工具进行调试： npm run inspector 然后访问生成的浏览器 URL 查看调试信息。

示例用法

干跑查询

调用 dry_run_query 方法验证查询合法性： dry_run_query("SELECT * FROM bigquery-public-data.samples.shakespeare LIMIT 10")

执行查询

调用 run_query_with_validation 方法运行带验证的查询： run_query_with_validation("SELECT word, word_count FROM bigquery-public-data.samples.shakespeare WHERE corpus='hamlet' LIMIT 10")