MCP Toolbox for Databases

Name: MCP Toolbox for Databases
Author: googleapis

@googleapis

代码仓库主页

关于 MCP Toolbox for Databases

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

#mcp #databases #llms #genai

基本信息

分类

其他

许可证

Apache-2.0

运行时

传输方式

stdio

发布者

googleapis

提交者

Yuan

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "toolbox": {
      "command": "./toolbox",
      "args": [
        "--stdio"
      ]
    }
  }
}

工具

name

概览

What is MCP Toolbox for Databases?

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: a ready‑to‑use prebuilt server with generic tools for instant data exploration, and a custom tools framework for building secure, production‑grade AI tools.

How to use MCP Toolbox for Databases?

For prebuilt tools, configure an MCP client (e.g., Gemini CLI, Claude Code) to run npx @toolbox-sdk/server --prebuilt=<database> and set the required environment variables. For custom tools, define a tools.yaml file with sources, tools, toolsets, and prompts, then run npx @toolbox-sdk/server --config tools.yaml. The server can also be installed as a binary or run via Docker.

Key features of MCP Toolbox for Databases

Out‑of‑the‑box database access with prebuilt generic tools
Custom tools framework for building safe, production‑ready tools
Handles connection pooling, integrated auth (IAM), and OpenTelemetry
Enhanced security with integrated authentication
Simplified development (integrate in less than 10 lines of code)
End‑to‑end observability with built‑in metrics and tracing

Use cases of MCP Toolbox for Databases

Query databases in plain English from your IDE or CLI
Automate schema discovery and management
Generate database‑aware code without context switching
Build specialized AI tools with restricted access and semantic search
Integrate database tools into LangChain, LlamaIndex, or custom agents

FAQ from MCP Toolbox for Databases

What databases does MCP Toolbox for Databases support?

Supported databases include Google Cloud databases (AlloyDB, BigQuery, Cloud SQL, Spanner, Firestore, Knowledge Catalog) and third‑party databases (PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, Trino, and more).

How do I install and run MCP Toolbox for Databases?

You can run it directly with npx @toolbox-sdk/server --config tools.yaml, or download a prebuilt binary from the releases page for Linux, macOS, or Windows. Container images are also available.

How do I configure custom tools?

Create a tools.yaml file with kind: source, kind: tool, kind: toolset, and kind: prompt sections. Then start the server with the --config tools.yaml flag. Detailed reference is available in the full documentation.

What is the difference between the self‑hosted Toolbox and Google Cloud MCP Servers?

Google Cloud MCP Servers provide a managed MCP experience with prebuilt tools. The open‑source Toolbox is self‑hosted and also offers a custom tools framework. More details can be found in the FAQ.

How does MCP Toolbox for Databases handle authentication and observability?

It supports integrated authentication (IAM) for secure access and provides end‑to‑end observability with built‑in support for OpenTelemetry metrics and tracing, all out of the box.