返回列表

MCP Toolbox for Databases|数据库MCP服务器与自定义工具框架

把 PostgreSQL、BigQuery、MySQL 等企业数据库接入 AI Agent 与 IDE 的开源 MCP 服务器,既能开箱即用地查表写 SQL,也能用配置文件自定义受控工具。

Agent 开发框架与运行时GoMCPClaude CodeGemini CLI数据库AI AgentPostgreSQLApache-2.0工具框架BigQuery站长实测状态尚未登记

工具介绍

这是什么

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 份有效分项记录

最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。

分项统计、有效期与样本量
核验项目有效人数成功 / 部分 / 失败 / 无法判断成功率最近核验 / 有效期
官方网站访问00 / 0 / 0 / 0样本不足暂无 / 7 天
GitHub 仓库访问00 / 0 / 0 / 0样本不足暂无 / 7 天
安装与运行00 / 0 / 0 / 0样本不足暂无 / 30 天
官方服务国内连接 / MCP 连接00 / 0 / 0 / 0样本不足暂无 / 30 天
国内网络情况00 / 0 / 0 / 0样本不足暂无 / 7 天
国内模型兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
自定义 API00 / 0 / 0 / 0样本不足暂无 / 30 天
海外服务依赖
00 / 0 / 0 / 0样本不足暂无 / 30 天
海外账号要求
00 / 0 / 0 / 0样本不足暂无 / 30 天
中文界面
00 / 0 / 0 / 0样本不足暂无 / 30 天
客户端兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
账号及费用信息
00 / 0 / 0 / 0样本不足暂无 / 30 天

成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。

最近有效核验

暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。

查看全部有效核验 →

反馈此内容的问题