Skip to main content

MCP Toolbox for Databases

MCP Toolbox for Databases is Google's official open-source server that connects AI agents like Claude and Gemini to databases. As of v1.9.0, its BigQuery source config supports an apiEndpoint field, so you can point it to route through Yuki instead of hitting bigquery.googleapis.com directly. That's what lets Yuki sit in front of BigQuery traffic coming from agentic tools, not just traditional query traffic, so agentic workloads get the same Yuki optimization as everything else.

Setup​

  1. Clone and build the toolbox, if you don't have it already:

    git clone https://github.com/googleapis/mcp-toolbox.git
    cd mcp-toolbox
    go build -o toolbox .

  2. Authenticate - make sure Application Default Credentials are set up:

    gcloud auth application-default login

  3. Point the BigQuery source at Yuki in your tools.yaml:

    kind: source
    name: my-bigquery-source
    type: bigquery
    project: "<your-gcp-project-id>"
    apiEndpoint: "https://<your-yuki-proxy-host>/bigquery/v2/"

  4. Run the toolbox:

    ./toolbox --config tools.yaml

Test the Connection​

The /api/* endpoints are disabled by default now - use the MCP JSON-RPC endpoint instead:

curl -X POST http://127.0.0.1:5000/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"execute_sql","arguments":{"sql":"SELECT 1"}}}'
Contents