MCP Toolbox教程：16.5k星Google开源数据库MCP服务器，Agent直连企业数据库

📌 项目：googleapis/mcp-toolbox | 星数：16.5k（2026-09-24） | 协议：Apache-2.0 | 语言：Go | GitHub

一句话定位："Google开源的数据库MCP服务器——让AI Agent安全直连企业数据库，SQL工具化、权限可控。" MCP Toolbox for Databases是Google出品的开源MCP服务器，将数据库操作封装为Agent可调用的工具，支持声明式工具定义、权限控制和多数据库后端。

🏗️ 双用途架构

MCP Toolbox服务双用途：

• 即用型MCP服务器（Build-Time）：开箱连接Gemini CLI、Google Antigravity等MCP客户端，零配置访问数据库
• 构建时工具配置：声明式定义SQL工具，控制Agent能执行哪些查询，细粒度权限管理

支持PostgreSQL、MySQL、SQLite、Spanner、AlloyDB等数据库。和 Supabase 提供完整后端不同，MCP Toolbox专注数据库层的MCP暴露。

🔧 声明式工具定义

通过YAML声明数据库工具：

# tools.yaml
sources:
  my-pg:
    kind: postgres
    host: localhost
    port: 5432
    database: mydb
    user: agent_user
    password: env(PG_PASSWORD)

tools:
  search_users:
    kind: postgres-sql
    source: my-pg
    description: "按名字搜索用户"
    parameters:
      - name: name
        type: string
        description: "用户名"
    statement: "SELECT * FROM users WHERE name LIKE $1"

Agent只能调用声明的工具，不能执行任意SQL——这是安全核心。

🚀 快速开始

# Docker启动
docker run -p 5000:5000 \
  -v ./tools.yaml:/app/tools.yaml \
  us-docker.pkg.dev/mcp-toolbox/toolbox/toolbox

# Python SDK使用
from toolbox_core import ToolboxClient

client = ToolboxClient("http://localhost:5000")
tools = client.load_toolset("search_users")
# tools可直接接入Agent框架

支持Python、JS/TS、Go、Java四种语言SDK。

⚖️ 优缺点