googleapis /mcp-toolbox
MCP Toolbox for Databases is an open source MCP server for databases.
★ 16,880⑂ 1,800👁 89⑃ 3,592● 869▤ 57
+8
Daily
16,880
stars
1,800
forks
89
watchers
3,592
prs
869
issues
57
releases
README
!logo MCP Toolbox for Databases MCP Toolbox for Databases is an open source Model Context Protocol (MCP) server that connects your AI agents, IDEs, and applications directly to your enterprise databases. It serves a dual purpose: 1. Ready-to-use MCP Server (Build-Time): Instantly connect Gemini CLI, Google Antigravity, Claude Code, Codex, or other MCP clients to your databases using our prebuilt generic tools. Talk to your data, explore schemas, and generate code without writing boilerplate. 2. 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. This README provides a brief overview. For comprehensive details, see the full documentation. [!IMPORTANT] Repository Name Update: The genai-toolbox repository has been officially renamed to mcp-toolbox. To ensure your local environment reflects the new name, you may update your remote: git remote set-url origin https://github.com/googleapis/mcp-toolbox.git [!NOTE] This solution was originally named “Gen AI Toolbox for Databases” (github.com/googleapis/genai-toolbox) as its initial development predated MCP, but was renamed to align with the MCP compatibility. Table of Contents - Why MCP Toolbox? - Quick Start: Prebuilt Tools - Quick Start: Custom Tools - Install & Run the Toolbox server - Connect to Toolbox - MCP Client - Toolbox SDKs: Integrate with your Application - Additional Features - Versioning - Contributing - Community --- Why MCP Toolbox? - 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. --- Quick Start: Prebuilt Tools Stop context-switching and let your AI assistant become a true co-developer. By connecting your IDE to your databases with MCP Toolbox, you can query your data in plain English, automate schema discovery and management, and generate database-aware code. You can use the Toolbox in any MCP-compatible IDE or client (e.g., Gemini CLI, Google Antigravity, Claude Code, Codex, etc.) by configuring the MCP server. Prebuilt tools are also conveniently available via the Google Antigravity MCP Store with a simple click-to-install experience. 1. Add th
Top issues
#1896Support for metdata for both sources and tools in tools.yaml and description for sources30 comments · 2025-11-07#715Proposal: Enabling MCP Toolbox for Databases as MCP Server26 comments · 2025-06-15#1327why there are duplicate parameters descrption in the tools ?18 comments · 2025-09-04#3373feat: Add policy-based automatic PII detection and dynamic masking17 comments · 2026-06-06#2290ArangoDB16 comments · 2026-01-11#3637Declarative per-tool result caps (maxRows / max response bytes) with a structured truncation notice11 comments · 2026-07-16#1527feat(cloud-sql-postgres): Support specifying tables in source configuration11 comments · 2025-09-22#2754Linux ARM64 build and releases8 comments · 2026-03-16
Latest release
v1.17.0 v1.17.0 2026-11-131.17.0 (2026-11-12) Features server,sources/looker: Add OAuth discovery/token CORS proxy for client-side OAuth (4290) (5111516) tool/looker: Add data app extension, dashboard, and layout tools (4411) (cabb8f5) Bug Fixes http: Preserve case-insensitive header precedence (4417) (8d54da0) server/mcp: Include ttlMs and cacheScope in server/discover result (4428) (d373dc1) tool/http: Skip optional header params that were not provided (4335) (79c8c86) tool/snowflake-sql: Scope list_tables name filter to the configured schema (4336) (e9e67d8) | OS/Architecture