工具介绍
这是什么
MCP Toolbox for Databases 是 Google 开源的一个 Model Context Protocol(MCP)服务器,用于把 AI Agent、IDE 和自建应用连接到数据库。项目早期的名字是 Gen AI Toolbox for Databases(仓库 genai-toolbox),后来仓库更名为 mcp-toolbox,本文按 README 中的正式称呼记录。
它同时承担两种角色:一是开箱即用的 MCP Server,在编码阶段让 Gemini CLI、Claude Code、Codex 等 MCP 客户端直接读取表结构、执行查询;二是自定义工具框架,用 YAML 声明受限查询、语义检索、自然语言转 SQL 等能力,交给生产环境的 Agent 调用。
本文为待审核草稿,功能与安装方式均整理自项目 README 与官方文档,未在本站环境实测。
真实功能(据 README)
- 预置通用工具:使用
--prebuilt=<数据库>启动时,直接获得list_tables、execute_sql这类标准工具;也可用--prebuilt=postgres/data只加载某一工具集。 - 支持的数据源:Google Cloud 侧包括 AlloyDB、BigQuery、Cloud SQL(PostgreSQL / MySQL / SQL Server)、Spanner、Firestore、Knowledge Catalog;其他包括 PostgreSQL、MySQL、MariaDB、SQL Server、Oracle、MongoDB、Redis、Elasticsearch、CockroachDB、ClickHouse、Couchbase、Neo4j、Snowflake、Trino 等。完整清单以官方 Prebuilt Tools Reference 为准。
tools.yaml配置:通过 sources / tools / toolsets / prompts / resources 五类声明,定义数据源、可执行动作、工具分组、提示词模板与只读资源。- 客户端 SDK:提供 Python(toolbox-core、toolbox-langchain、toolbox-llamaindex)、JS/TS(@toolbox-sdk/core、adk)、Go、Java 等 SDK,README 称可在少量代码内接入 ADK、LangChain、LlamaIndex、Genkit 等框架。
- 性能与可观测性:README 声明内置连接池、IAM 集成认证、基于 OpenTelemetry 的指标与链路追踪,可用
--telemetry-otlp=<endpoint>导出。 - Toolbox UI:
--ui参数启动交互界面,用于调试工具与工具集。 - 生成 Agent Skill:
skills-generate子命令可把某个 toolset 打包成符合 Agent Skill 规范的可分发技能包。 - 动态重载:默认开启配置热加载,可用
--disable-reload关闭。
适用人群
- 希望让 AI 编程助手直接读库、查表、生成贴合真实 schema 代码的后端与数据工程师;
- 需要给生产 Agent 提供受控数据库访问能力的平台或 Agent 开发团队;
- 已在用 Gemini CLI、Claude Code、Codex、ADK、LangChain 等技术栈,想低成本补上数据层工具的人;
- 不太适合只想点开一个网页就能查库、不打算写 YAML 配置的用户。
环境门槛
- 需要一个可访问的目标数据库,以及对应的账号权限;预置工具默认能力较大,生产环境应配合只读账号与最小权限。
- 运行方式任选:官方发布的二进制(Linux AMD64、macOS Apple Silicon / Intel、Windows AMD64 / ARM64)、容器镜像、Homebrew、
go install(需 Go 环境)、或npx @toolbox-sdk/server(需 Node.js)。 - MCP 客户端侧需要在配置文件中加入 MCP Server 条目,多数 IDE 使用
mcp.json或claude_desktop_config.json。 - 若使用 SDK 集成,还需对应的 Python / Node / Go / Java 运行时。
安装与使用(摘自官方文档,未实测)
以 npm 临时运行预置 PostgreSQL 工具为例,README 给出的 MCP 客户端配置为:
{
"mcpServers": {
"toolbox-postgres": {
"command": "npx",
"args": ["-y", "@toolbox-sdk/server", "--prebuilt=postgres", "--stdio"]
}
}
}
自定义工具的运行方式:先写好 tools.yaml,再执行 toolbox --config "tools.yaml";随后在 MCP 客户端中把地址指向 http://127.0.0.1:5000/mcp(或 /mcp/{toolset_name} 指定工具集)。Docker、Homebrew 与源码编译的具体命令请以 README 与 releases 页面为准,版本号随发布变化。
费用与许可
- 项目以 Apache License 2.0 发布,可商用与修改,但再分发需保留许可证与版权声明,具体条款以仓库 LICENSE 原文为准。
- 工具本身免费;但它连接的数据库(如 BigQuery、Cloud SQL、Snowflake 等)会产生各自的云服务费用。README 另提到 Google Cloud 提供托管版 MCP Servers,其计费方式与开源版不同,需另行核查。
国内使用与合规提示(待核查)
- 二进制下载地址指向
storage.googleapis.com,容器镜像托管在us-central1-docker.pkg.dev,国内网络可达性与下载速度待核查,必要时需自建镜像或代理。 - 若接入 Google Cloud 数据库与 IAM 认证,跨境访问与账号合规要求需自行评估。
- 任何把生产库暴露给大模型的方案,都应先评估数据出境、敏感字段脱敏与审计留痕问题。
待核查清单
- 各数据库预置工具的具体权限范围与默认行为;
- Toolbox UI、
skills-generate、遥测导出等功能在当前版本的完整可用性; - 国内网络下的实际安装成功率和镜像替代方案;
- 与托管版 Google Cloud MCP Servers 的功能与价格差异。
来源与加工说明
来源:https://github.com/googleapis/mcp-toolbox
许可证:Apache-2.0
依据 GitHub 原始资料由 AI 整理的中文待审核草稿,未经本站实测。原始版权与许可归原作者;未声明许可不代表允许转载或再分发。
来源类型:GitHub;授权范围待核验
运行与适配
如何理解使用难度?
- 直接使用:通常打开网页或登录账号即可使用。
- 简单配置:需要填写密钥、连接服务或导入配置。
- 需要部署:需要安装依赖、配置运行环境或自行部署。
- 技术开发:需要编程、接口集成或开发调试。
格数越多,使用门槛越高;具体要求请看下方说明。
国内可用性待核验
访问来源 ↗国内使用情况与网友核验
网友核验 用户经验分享
与站长实测独立,不代表官方认证或本站已实测。
最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。
分项统计、有效期与样本量
| 核验项目 | 有效人数 | 成功 / 部分 / 失败 / 无法判断 | 成功率 | 最近核验 / 有效期 |
|---|---|---|---|---|
| 官方网站访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| GitHub 仓库访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 安装与运行 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 官方服务国内连接 / MCP 连接 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 国内网络情况 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 国内模型兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 自定义 API | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外服务依赖 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外账号要求 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 中文界面 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 客户端兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 账号及费用信息 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。
最近有效核验
暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。
查看全部有效核验 →