MCP Toolbox for Databases 是 Google 开源的数据库 MCP 服务器,旨在将 AI 智能体、IDE 与应用程序连接到企业数据库。项目最初的名称是“Gen AI Toolbox for Databases”(仓库 genai-toolbox),由于早期开发早于 MCP 协议,后更名为 mcp-toolbox 以体现与 MCP 的兼容性。
【用途】 该工具具有双重用途:其一,作为开箱即用的 MCP 服务器(构建时),可立即将 Gemini CLI、Google Antigravity、Claude Code、Codex 等 MCP 客户端连接到数据库,使用预构建的通用工具进行数据查询、模式探索和代码生成,无需编写样板代码。其二,作为自定义工具框架(运行时),提供构建专用、高安全性 AI 工具的能力,支持定义结构化查询、语义搜索和 NL2SQL,适用于生产环境智能体。
【主要能力】
- 开箱即用的数据库访问:预构建通用工具(如 list_tables、execute_sql),可直接从 IDE 或 CLI 探索数据。
- 自定义工具框架:通过 tools.yaml 配置文件定义源(sources)、工具(tools)、工具集(toolsets)和提示(prompts),实现受限访问、结构化查询和语义搜索。
- 简化开发:可在 10 行代码内集成到 Agent Development Kit(ADK)、LangChain、LlamaIndex 或自定义智能体。
- 性能与可观测性:内置连接池、IAM 集成认证和端到端可观测性(OpenTelemetry),提供开箱即用的指标和追踪。
- 增强安全性:集成认证,实现更安全的数据访问。
【支持的数据库】 Google Cloud:AlloyDB、BigQuery、Cloud SQL(PostgreSQL、MySQL、SQL Server)、Spanner、Firestore、Knowledge Catalog(原 Dataplex)。 其他数据库:PostgreSQL、MySQL、MariaDB、SQL Server、Oracle、MongoDB、Redis、Elasticsearch、CockroachDB、ClickHouse、Couchbase、Neo4j、Snowflake、Trino 等。
【使用方式】
- 安装与运行:支持二进制、Docker 容器、Homebrew、源码编译,也可通过 npx 直接运行(需 Node.js)。安装后使用 toolbox 命令启动服务器,使用 --config 指定配置文件,--prebuilt=<database> 加载预构建工具,--prebuilt=<database>/<toolset> 加载特定工具集。
- 连接 MCP 客户端:在 mcp.json 或 claude_desktop_config.json 中配置 MCP 服务器。例如: { "mcpServers": { "toolbox-postgres": { "command": "npx", "args": ["-y", "@toolbox-sdk/server", "--prebuilt=postgres", "--stdio"] } } } 此后可加载工具到兼容的 MCP 客户端或应用,连接特定工具集时使用 URL http://127.0.0.1:5000/mcp/{toolset_name}。
- 自定义工具:通过 tools.yaml 定义 sources、tools、toolsets、prompts、resources 等,运行 toolbox 启动服务器。支持动态重载(默认开启,可通过 --disable-reload 禁用)。
- SDK 集成:提供 Python(toolbox-core、toolbox-langchain、toolbox-llamaindex)、JavaScript/TypeScript(@toolbox-sdk/core、@toolbox-sdk/adk)和 Go(mcp-toolbox-sdk-go)等客户端 SDK,便于在应用中加载工具集。
【适用场景】 适用于需要将 AI 智能体或 IDE 连接到数据库的开发场景,包括数据探索、模式管理、代码生成、构建生产级数据库 AI 工具、自然语言查询数据库等。
【限制】 具体性能指标、收费模式、价格、平台兼容性细节等暂未提供。部分高级功能(如语义搜索、NL2SQL)的具体实现细节需参考官方文档。