mcp-toolbox

MCP Toolbox for Databases is an open source MCP server for databases.

What is mcp-toolbox?

MCP Toolbox for Databases is an open source MCP server for databases.

Overview of mcp-toolbox

What it is

MCP Toolbox for Databases is an open source Model Context Protocol (MCP) server that connects AI agents, IDEs, and applications directly to enterprise databases. It serves a dual purpose: as a ready-to-use MCP server with prebuilt generic tools for instant data exploration, and as a custom tools framework for building specialized, secure AI tools for production agents.

Key features

  • Out-of-the-box database access with prebuilt generic tools (e.g., list_tables, execute_sql) for instant data exploration from IDE or CLI.
  • Custom tools framework to build production-ready tools with predefined logic, supporting Restricted Access, Structured Queries, and Semantic Search.
  • Simplified development: integrate tools into Agent Development Kit (ADK), LangChain, LlamaIndex, or custom agents in less than 10 lines of code.
  • Better performance with built-in connection pooling, integrated authentication (IAM), and end-to-end observability (OpenTelemetry).
  • Enhanced security through integrated authentication for secure data access.
  • End-to-end observability with out-of-the-box metrics and tracing via OpenTelemetry.

Use cases

  • Connect AI assistants (Gemini CLI, Google Antigravity, Claude Code, Codex) to databases for querying data in plain English, automating schema discovery, and generating database-aware code.
  • Build custom tools for production agents with structured queries, semantic search, and NL2SQL capabilities.
  • Use in any MCP-compatible IDE or client by configuring the MCP server.

Getting started

For prebuilt tools (e.g., PostgreSQL), add the following to your MCP client configuration:

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

For custom tools, run with a configuration file:

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

See the repository README for detailed setup instructions and environment variables.

License and pricing

Licensed under Apache-2.0. The project is open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/googleapismcp-toolbox.svg)](https://yunodb.com/tools/googleapismcp-toolbox?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/googleapismcp-toolbox?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/googleapismcp-toolbox.svg" alt="Featured on YunoDB" height="20"></a>