A Model Context Protocol (MCP) server for secure BigQuery access across multiple Google Cloud projects with advanced analytics, security controls, and Docker support.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add bigquery-aicayzer --env PROJECT_PATTERN='<PROJECT_PATTERN>' --env BILLING_PROJECT='<BILLING_PROJECT>' -- python src/server.py --project '{{config.PROJECT_PATTERN}}' --billing-project '{{config.BILLING_PROJECT}}'~/.codex/config.toml
[mcp_servers.bigquery-aicayzer]
command = "python"
args = ["src/server.py", "--project", "{{config.PROJECT_PATTERN}}", "--billing-project", "{{config.BILLING_PROJECT}}"]
env = { PROJECT_PATTERN = "<PROJECT_PATTERN>", BILLING_PROJECT = "<BILLING_PROJECT>" }
# codex mcp add bigquery-aicayzer --env PROJECT_PATTERN='<PROJECT_PATTERN>' --env BILLING_PROJECT='<BILLING_PROJECT>' -- python src/server.py --project '{{config.PROJECT_PATTERN}}' --billing-project '{{config.BILLING_PROJECT}}'~/.cursor/mcp.json
{
"mcpServers": {
"bigquery-aicayzer": {
"command": "python",
"args": [
"src/server.py",
"--project",
"{{config.PROJECT_PATTERN}}",
"--billing-project",
"{{config.BILLING_PROJECT}}"
],
"env": {
"PROJECT_PATTERN": "<PROJECT_PATTERN>",
"BILLING_PROJECT": "<BILLING_PROJECT>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"bigquery-aicayzer": {
"type": "stdio",
"command": "python",
"args": [
"src/server.py",
"--project",
"{{config.PROJECT_PATTERN}}",
"--billing-project",
"{{config.BILLING_PROJECT}}"
],
"env": {
"PROJECT_PATTERN": "<PROJECT_PATTERN>",
"BILLING_PROJECT": "<BILLING_PROJECT>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"bigquery-aicayzer": {
"command": "python",
"args": [
"src/server.py",
"--project",
"{{config.PROJECT_PATTERN}}",
"--billing-project",
"{{config.BILLING_PROJECT}}"
],
"env": {
"PROJECT_PATTERN": "<PROJECT_PATTERN>",
"BILLING_PROJECT": "<BILLING_PROJECT>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"bigquery-aicayzer": {
"command": "python",
"args": [
"src/server.py",
"--project",
"{{config.PROJECT_PATTERN}}",
"--billing-project",
"{{config.BILLING_PROJECT}}"
],
"env": {
"PROJECT_PATTERN": "<PROJECT_PATTERN>",
"BILLING_PROJECT": "<BILLING_PROJECT>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"bigquery-aicayzer": {
"command": "python",
"args": [
"src/server.py",
"--project",
"{{config.PROJECT_PATTERN}}",
"--billing-project",
"{{config.BILLING_PROJECT}}"
],
"env": {
"PROJECT_PATTERN": "<PROJECT_PATTERN>",
"BILLING_PROJECT": "<BILLING_PROJECT>"
}
}
}
}Environment variables
PROJECT_PATTERNBILLING_PROJECT
Replace the placeholders with your own credentials and keep them out of version control.