MCP Toolbox for Databases

MCP Toolbox for Databases 是什么

MCP Toolbox for Databases 是 Google 开源的一个 Model Context Protocol（MCP）服务器，用于把 AI 智能体、IDE 和应用程序直接连接到企业数据库。它最初叫 Gen AI Toolbox for Databases，后因 MCP 生态兴起而更名。

项目采用 Go 编写，遵循 Apache-2.0 协议，目前已有 1.6 万+ Star。

双重定位

1. 开箱即用的 MCP 服务器（构建期）：通过预置的通用工具（如 list_tables、execute_sql），让 Gemini CLI、Claude Code、Codex 等 MCP 客户端立刻连接数据库，用自然语言探索 Schema、查询数据、生成代码。
2. 自定义工具框架（运行期）：为生产级 Agent 构建专用、安全的数据库工具，支持结构化查询、语义检索与 NL2SQL 能力。

核心特性

• 开箱即用的数据库访问：预置工具覆盖 PostgreSQL、MySQL、BigQuery、Spanner、Firestore、MongoDB、Redis、Elasticsearch、ClickHouse、Oracle 等 20 多种数据源。
• 自定义工具框架：通过 tools.yaml 声明式定义数据源与工具，配合受限访问、结构化查询与语义搜索保障安全。
• 简化开发：不到 10 行代码即可把工具接入 ADK、LangChain、LlamaIndex 或自研 Agent。
• 性能与可观测性：内置连接池、IAM 集成认证，以及基于 OpenTelemetry 的指标与链路追踪。

快速上手思路

使用预置工具

在 MCP 客户端的配置文件中加入服务器配置，例如：

{
  "mcpServers": {
    "toolbox-postgres": {
      "command": "npx",
      "args": ["-y", "@toolbox-sdk/server", "--prebuilt=postgres", "--stdio"]
    }
  }
}

再按文档设置对应数据库的环境变量即可。使用 --prebuilt=<database>/<toolset> 还能只加载特定工具集。

使用自定义工具

通过 tools.yaml 定义数据源与工具：

kind: source
name: my-pg-source
type: postgres
host: 127.0.0.1
port: 5432
database: toolbox_db
user: toolbox_user
password: my-password

随后用 --config tools.yaml 启动服务器，即可让 Agent 调用你定义的受控查询。

适用人群

• 希望让 AI 编程助手直接访问数据库的开发者
• 需要为生产 Agent 构建安全数据库工具的后端团队
• 使用 Google Cloud 数据服务（BigQuery、Spanner、AlloyDB 等）的工程团队

注意事项

• 仓库已从 genai-toolbox 更名为 mcp-toolbox，本地仓库需更新 remote 地址。
• 官方文档与社区以英文为主，中文资料相对有限。
• 若使用 Google Cloud 数据源，需要配置 GCP 账号与 IAM 权限。