MCP Toolbox for Databases

An open source Model Context Protocol (MCP) server that connects AI agents, IDEs, and applications directly to enterprise databases. It serves a dual purpose:

Ready-to-use MCP Server (Build-Time)

Instantly connect Gemini CLI, Google Antigravity, Claude Code, Codex, or other MCP clients to your databases using prebuilt generic tools. Talk to your data, explore schemas, and generate code without writing boilerplate.

Prebuilt tools are also conveniently available via the Google Antigravity MCP Store with a simple click-to-install experience.

Supported databases include:

• Google Cloud: AlloyDB, BigQuery, Cloud SQL (PostgreSQL, MySQL, SQL Server), Spanner, Firestore, Knowledge Catalog (formerly known as Dataplex)
• Other Databases: PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, Trino, and more

Custom Tools Framework (Run-Time)

A robust framework to build specialized, highly secure AI tools for your production agents. Define structured queries, semantic search, and NL2SQL capabilities safely and easily through a tools.yaml configuration file.

Key Features

• Out-of-the-Box Database Access: Prebuilt generic tools for instant data exploration (e.g., list_tables, execute_sql) directly from your IDE or CLI
• Custom Tools Framework: Build production-ready tools with your own predefined logic, ensuring safety through Restricted Access, Structured Queries, and Semantic Search
• Simplified Development: Integrate tools into your Agent Development Kit (ADK), LangChain, LlamaIndex, or custom agents in less than 10 lines of code
• Better Performance: Handles connection pooling, integrated auth (IAM), and end-to-end observability (OpenTelemetry) out of the box
• Enhanced Security: Integrated authentication for more secure access to your data
• End-to-end Observability: Out of the box metrics and tracing with built-in support for OpenTelemetry

Usage

Prebuilt Tools

For prebuilt database tools, use the --prebuilt flag:

{
  "mcpServers": {
    "toolbox-postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@toolbox-sdk/server",
        "--prebuilt=postgres",
        "--stdio"
      ]
    }
  }
}

Custom Tools

Define your custom tools in a tools.yaml configuration file and run:

npx @toolbox-sdk/server --config tools.yaml

Then connect via HTTP:

{
  "mcpServers": {
    "toolbox": {
      "type": "http",
      "url": "http://127.0.0.1:5000/mcp"
    }
  }
}

Additional Features

• Toolbox UI: Launch with --ui flag for interactive testing
• Telemetry: Export OpenTelemetry traces and metrics with --telemetry-otlp
• Agent Skills: Generate Agent Skills from toolsets using skills-generate command

Client SDKs

Toolbox provides SDKs for multiple languages and frameworks:

• Python: Core, LangChain, LlamaIndex
• JavaScript/TypeScript: Core, LangChain, Genkit, ADK
• Go: Core, LangChain Go, Genkit, Go GenAI, OpenAI Go, ADK Go
• Java: Maven Central package available