MCP Toolbox：把企业数据库接到 AI 工具的协议服务器

MCP Toolbox for Databases 在 GitHub 上已经拿到 15,760 Star。

这是 Google 开源的一个 MCP 服务器，作用很明确：让 AI 代理、IDE 和应用直接访问企业数据库。它提供两类用法：开箱即用的预置工具，以及自定义工具框架。

1、这玩意儿是干嘛的

MCP Toolbox 是一个实现了 Model Context Protocol 协议的服务器。把它接入 Gemini CLI、Claude Code、Codex 等 MCP 客户端后，用户可以用自然语言查询数据库、查看表结构、执行 SQL，不需要写胶水代码。

MCP 是 Anthropic 推动的开放协议，目标是把外部数据源和工具以统一方式暴露给大模型。Toolbox 做的事就是把数据库这层能力封装成 MCP 工具，让模型知道它能查什么、能改什么，调用结果也能按协议格式返回。

它也支持作为开发框架使用。开发者可以通过 tools.yaml 定义自己的查询工具、语义检索工具或 NL2SQL 能力，再集成到 ADK、LangChain、LlamaIndex 等框架里。这种模式下，你不再是简单调用预置接口，而是在 Toolbox 之上构建面向业务的专业工具。

这个项目最早叫 Gen AI Toolbox for Databases，后来为了对齐 MCP 协议改名为 MCP Toolbox，代码仓库也从 genai-toolbox 迁移到了 mcp-toolbox。

2、支持哪些数据库

预置工具覆盖了主流数据库。Google Cloud 侧包括 AlloyDB、BigQuery、Cloud SQL、Spanner、Firestore、Knowledge Catalog；其他数据库包括 PostgreSQL、MySQL、SQL Server、Oracle、MongoDB、Redis、Elasticsearch、CockroachDB、ClickHouse、Couchbase、Neo4j、Snowflake、Trino 等。

启动预置工具时，只需要指定数据库类型，Toolbox 就会自动加载对应的工具集，比如 list_tables、execute_sql 这类通用操作。也可以按 toolset 加载，只暴露最小权限的集合，避免一次性把所有能力都交给客户端。

3、怎么用

最简单的方式是用 npm 直接跑预置工具：

npx @toolbox-sdk/server --prebuilt=postgres --stdio

也可以下载二进制、拉取 Docker 镜像，或者用 Homebrew 安装：

brew install mcp-toolbox

自定义工具通过 tools.yaml 配置。文件里主要写四类资源：sources 定义数据源连接，tools 定义具体动作，toolsets 把工具分组，prompts 预设给模型的提示词。配置完成后启动服务器即可：

./toolbox --config tools.yaml

服务器跑起来后，MCP 客户端通过本地 5000 端口的 /mcp 路径连接，就能加载工具。应用端也可以用 SDK 直接调用 load_toolset，把工具集成进自己的业务代码。

4、还提供了什么

项目为 Python、JavaScript/TypeScript、Go、Java 提供了 SDK，方便在应用里直接加载工具集。这些 SDK 覆盖了核心调用、LangChain、LlamaIndex、Genkit、ADK 等集成方式，基本能把 Toolbox 接进现有技术栈。

安全方面，Toolbox 内置 IAM 认证和参数校验，支持 Restricted Access，避免模型拿到超出范围的权限。运行时还带了连接池管理、OpenTelemetry 可观测性，以及一个 Web UI 用于手动测试工具和查看调用结果。连接池和认证这类基础设施能力通常要自己搭，Toolbox 直接内置了，省去了不少运维工作。

另外有一个比较实用的功能：skills-generate。它可以把一个 toolset 导出成 Agent Skill 包，直接安装到 Gemini CLI 里复用。这对想把内部数据能力做成可分发工具的团队来说，省了重复配置的麻烦。

5、适合谁

• 需要让 AI 编程工具直接操作数据库的开发者
• 正在搭建 Agent，想把数据库查询封装成安全可控工具的工程师
• 不想为每种数据库单独写接入层的技术团队
• 需要把 NL2SQL、语义检索这类能力产品化的团队
• 希望在 IDE 里用自然语言查数据、生成代码的工程师

技术团队

• 需要把 NL2SQL、语义检索这类能力产品化的团队
• 希望在 IDE 里用自然语言查数据、生成代码的工程师