MCP Toolbox for Databases

MCP Toolbox for Databases 是由 Google googleapis 组织维护的开源 Model Context Protocol (MCP) 服务器，旨在作为中间控制平面，将 AI 代理、IDE 和应用直接且安全地连接到企业数据库。项目采用 Go 语言（96.2%）构建核心服务，遵循 Apache-2.0 许可证，当前最新版本为 v1.1.0（语义化版本控制）。

双模运行机制#

• 即用型预构建工具：零代码配置，通过 --prebuilt 参数即刻为 Gemini CLI、Claude Code、Codex 等 MCP 客户端提供通用数据库探索能力（如 list_tables、execute_sql）。
• 自定义工具框架：通过声明式 tools.yaml 配置文件定义 Source（数据源）、Tool（执行动作）、Toolset（工具分组）、Prompt（提示模板）四种资源类型，构建支持受限访问、结构化查询和语义搜索的高安全性生产级工具。

数据源支持范围#

Google Cloud 全系列：AlloyDB、BigQuery、Cloud SQL（PostgreSQL/MySQL/SQL Server）、Spanner、Firestore、Knowledge Catalog。

主流第三方数据库：PostgreSQL、MySQL、SQL Server、Oracle、MongoDB、Redis、Elasticsearch、CockroachDB、ClickHouse、Couchbase、Neo4j、Snowflake、Trino 等，总计 20+ 种。

企业级治理#

• 安全管控：集成 IAM 认证，支持结构化查询与受限访问，防止越权操作。
• 可观测性：内置 OpenTelemetry 支持的指标和追踪，可通过 --telemetry-otlp 导出至 Google Cloud Monitoring 等 OTLP 兼容后端。
• 高性能：内置连接池管理。

开发者体验#

• 低代码集成：不到 10 行代码即可集成到 ADK、LangChain、LlamaIndex 等框架。
• 动态重载：默认启用配置文件热重载（可通过 --disable-reload 关闭）。
• 交互式测试 UI：通过 --ui 标志启动 Web UI 进行工具调试。
• Agent Skills 打包：通过 skills-generate 子命令将工具集转换为符合 Agent Skill 规范的可移植技能包，直接安装至 Gemini CLI。

架构要点#

采用中间控制平面架构，位于上层应用编排框架与下层物理数据库之间，基于标准 MCP 协议使用 HTTP 传输（默认端口 5000），核心端点 /mcp，支持按工具集名称路由（/mcp/{toolset_name}）。支持自定义 Source 和 Tool 类型扩展（详见仓库内 MCP-TOOLBOX-EXTENSION.md）。

安装部署#

• NPM 方式：npx @toolbox-sdk/server --config tools.yaml 或 npx @toolbox-sdk/server --prebuilt=postgres
• 二进制：从 Google Cloud Storage 下载对应平台二进制文件
• Docker：提供容器镜像
• Homebrew：brew install 支持
• 源码编译：需 Go 环境

多语言 SDK#

• Python：toolbox-core、toolbox-langchain（适配 LangChain/LlamaIndex）
• JavaScript/TypeScript：@toolbox-sdk/core（适配 LangChain/Genkit/LlamaIndex/ADK）
• Go：github.com/googleapis/mcp-toolbox-sdk-go（适配 LangChain Go/Genkit Go/OpenAI Go/ADK Go）

待确认事项#

• 语义搜索底层向量数据库依赖（如是否需要 pgvector）未在文档中明确说明
• NL2SQL 具体实现机制细节待进一步查阅
• Google Antigravity MCP Store 的公开访问方式和范围待确认
• Cloudflare 集成与 Looker 工具的定位待确认