MCP Toolbox for Databases logo

MCP Toolbox for Databases

Connects MCP-compatible agents and IDEs to databases through prebuilt tools or YAML-defined custom tools.

Install MCP Toolbox for Databases

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-toolbox-for-databases": {
      "command": "npx",
      "args": [
        "-y",
        "@toolbox-sdk/server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @toolbox-sdk/server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked .

Overview

MCP Toolbox for Databases connects MCP clients, IDEs, and applications to enterprise databases through a ready-to-run server and a custom tool framework. Prebuilt configurations provide tools such as `list_tables` and `execute_sql` for schema discovery, data access, and database-aware code generation. Developers can instead define sources, parameterized queries, toolsets, and prompts in `tools.yaml`, including structured queries, semantic search, and NL2SQL workflows. Reach for it when an agent needs controlled database access across systems such as PostgreSQL, BigQuery, AlloyDB, Spanner, MongoDB, Redis, or Snowflake.

Use cases

  • Explore database schemas from an MCP-compatible IDE
  • Query operational data with predefined SQL tools
  • Define restricted database actions for production agents
  • Group tools for different applications or agents

Key features

  • Prebuilt database configurations
  • YAML-defined custom tools
  • Structured queries and semantic search
  • NL2SQL support
  • Connection pooling and IAM authentication
  • OpenTelemetry metrics and tracing

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

54/54 checks healthy over the last 71d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · @toolbox-sdk/server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars16kStargazers on the source repository.
npm downloads197kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity10 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Toolbox for Databases works

What MCP Toolbox for Databases does

MCP Toolbox for Databases exposes database access to MCP-compatible agents, IDEs, and applications. It supports ready-made database configurations for Google Cloud systems such as AlloyDB, BigQuery, Cloud SQL, Spanner, Firestore, and Knowledge Catalog, as well as databases including PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, and Trino.

The prebuilt mode is intended for immediate database exploration and interaction. Depending on the selected database, agents can use generic capabilities such as listing tables and executing SQL. The same server can also support production-oriented custom tools with predefined logic, restricted access, structured queries, semantic search, and NL2SQL.

How it works

An MCP client starts Toolbox and communicates with it through the MCP interface. The server can load a complete prebuilt configuration with a flag such as --prebuilt=postgres, or load only a named toolset, for example --prebuilt=postgres/data. Toolsets let an application expose selected groups of tools rather than the entire database configuration.

For custom deployments, a tools.yaml file describes the available data sources and agent actions. A source defines connection information for a database. Each tool identifies its type, source, parameters, description, and query or other execution logic. Toolsets group tools for different agents or applications, while prompt resources define prompts for interactions with language models.

The project also provides SDKs for Python, JavaScript/TypeScript, Go, and Java. These support integrating Toolbox capabilities into applications and agent frameworks such as Agent Development Kit, LangChain, and LlamaIndex.

Setup and configuration

A client configuration can launch the prebuilt server with the Toolbox npm package. For PostgreSQL, the example uses npx -y @toolbox-sdk/server --prebuilt=postgres --stdio. Database connection settings are then supplied according to the selected prebuilt configuration.

Custom configurations are stored in tools.yaml and selected with the --config tools.yaml option. A typical source includes a database type, host, port, database name, username, and password. A custom SQL tool can reference that source and bind named parameters to a predefined statement.

Toolbox can also be run using Docker or binaries. Its runtime includes connection pooling, integrated authentication support including IAM, and OpenTelemetry support for metrics and tracing.

Tools and capabilities

  • Prebuilt generic database tools for supported systems
  • Table listing and SQL execution
  • Schema exploration and database-aware code generation
  • Custom tools backed by predefined queries or logic
  • Structured queries, restricted access, semantic search, and NL2SQL
  • Toolset-based grouping and selective loading
  • OpenTelemetry metrics and tracing

The available tools vary by database and selected toolset. The prebuilt database and toolset flags determine which capabilities an MCP client receives.

Limitations and notes

Database support and available tools are configuration-dependent. A prebuilt setup may expose different capabilities from a custom tools.yaml deployment, and selecting a toolset limits the loaded tools. The project was previously named Gen AI Toolbox for Databases and is now maintained under the mcp-toolbox repository name.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Toolbox for Databases

MCP Toolbox for Databases is an MCP server that connects AI agents, IDEs, and applications to enterprise databases. Its main tools support table listing, SQL execution, schema exploration, and database-aware code generation, while custom configurations add predefined queries, structured access, semantic search, and NL2SQL workflows.

Install it by configuring an MCP client to run the Toolbox package with a prebuilt database flag, such as `npx -y @toolbox-sdk/server --prebuilt=postgres --stdio`. You can also run Toolbox from Docker or a binary and provide the database-specific connection configuration.

Configure custom database tools in a `tools.yaml` file and start Toolbox with `--config tools.yaml`. Define sources for database connections, tools with parameters and statements, toolsets for grouped loading, and prompts for model interactions.

Yes, it can work with Cursor when configured as an MCP-compatible client. Add the Toolbox launch command and its arguments to Cursor’s MCP configuration, then provide the connection settings required by the selected prebuilt database or custom configuration.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Toolbox for Databases AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-toolbox-for-databases?style=directory)](https://allmcps.com/mcp/mcp-toolbox-for-databases)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-toolbox-for-databases"><img src="https://allmcps.com/api/badge/mcp-toolbox-for-databases?style=directory" alt="MCP Toolbox for Databases on AllMCPs" /></a>