MCP Toolbox for Databases

MCP Toolbox for Databases 是一个开源的 Model Context Protocol (MCP) 服务器，可将您的 AI 代理、IDE 和应用程序直接连接到企业数据库。

它服务于双重目的：

1. 开箱即用的 MCP 服务器（构建时）： 使用我们的预构建通用工具，立即将 Gemini CLI、Google Antigravity、Claude Code、Codex 或其他 MCP 客户端连接到您的数据库。与您的数据对话、探索 schema 并生成代码，无需编写样板代码。
2. 自定义工具框架（运行时）： 一个强大的框架，用于为您的生产代理构建专业化、高度安全的 AI 工具。安全、轻松地定义结构化查询、语义搜索和 NL2SQL 功能。

本 README 提供简要概述。如需完整详细信息，请参阅完整文档。

[!IMPORTANT] 仓库名称更新： genai-toolbox 仓库已正式更名为 mcp-toolbox。为确保您的本地环境反映新名称，您可以更新远程地址： git remote set-url origin https://github.com/googleapis/mcp-toolbox.git

[!NOTE] 该解决方案最初名为“Gen AI Toolbox for Databases”（github.com/googleapis/genai-toolbox），因为其初始开发早于 MCP，但后来更名为与 MCP 兼容。

目录

• 为什么选择 MCP Toolbox？
• 快速入门：预构建工具
• 快速入门：自定义工具
• 安装并运行 Toolbox 服务器
• 连接到 Toolbox
  • MCP 客户端
  • Toolbox SDK：与您的应用程序集成
• 附加功能
• 版本控制
• 贡献
• 社区

---

为什么选择 MCP Toolbox？

• 开箱即用的数据库访问： 预构建的通用工具，可直接从 IDE 或 CLI 进行即时数据探索（例如 list_tables、execute_sql）。
• 自定义工具框架： 使用您自己的预定义逻辑构建生产就绪的工具，通过受限访问、结构化查询和语义搜索确保安全性。
• 简化开发： 在不到 10 行代码内将工具集成到您的 Agent Development Kit (ADK)、LangChain、LlamaIndex 或自定义代理中。
• 更佳性能： 开箱即用地处理连接池、集成身份验证（IAM）和端到端可观测性（OpenTelemetry）。
• 增强安全性： 集成身份验证，更安全地访问您的数据。
• 端到端可观测性： 内置 OpenTelemetry 支持，开箱即用地提供指标和追踪。

---

快速入门：预构建工具

停止上下文切换，让您的 AI 助手成为真正的共同开发者。通过使用 MCP Toolbox 将 IDE 连接到数据库，您可以用自然语言查询数据、自动化 schema 发现和管理，并生成数据库感知的代码。

您可以通过配置 MCP 服务器，在任何兼容 MCP 的 IDE 或客户端（例如 Gemini CLI、Google Antigravity、Claude Code、Codex 等）中使用 Toolbox。

预构建工具还可通过 Google Antigravity MCP Store 方便地获取，提供简单的点击安装体验。

快速入门：自定义工具

Toolbox 框架允许您使用自定义逻辑定义自己的工具。这对于需要强制执行特定安全和治理策略的生产场景非常有用。

例如，您可以定义一个工具，用于：

• 使用预定义参数执行结构化查询。
• 对数据执行语义搜索。
• 使用 NL2SQL 将自然语言转换为 SQL。

这些工具可以通过 Toolbox SDK 集成到您的代理中。

安装并运行 Toolbox 服务器

您可以使用 Docker、二进制发行版或从源代码安装并运行 Toolbox 服务器。

Docker

docker run -p 5000:5000 \
  -v ./config.yaml:/config.yaml \
  us-docker.pkg.dev/cloud-devrel-public-resources/toolbox/mcp-toolbox:latest \
  --config /config.yaml

二进制发行版

从 Releases 页面下载最新的二进制文件。

从源代码构建

git clone https://github.com/googleapis/mcp-toolbox.git
cd mcp-toolbox
go build ./...

有关详细的安装说明，请参阅安装指南。

连接到 Toolbox

MCP 客户端

通过添加以下配置，将您的 MCP 客户端连接到 Toolbox 服务器：

{
  "mcpServers": {
    "toolbox": {
      "command": "docker",
      "args": ["run", "-p", "5000:5000", "-v", "./config.yaml:/config.yaml", "us-docker.pkg.dev/cloud-devrel-public-resources/toolbox/mcp-toolbox:latest", "--config", "/config.yaml"]
    }
  }
}

Toolbox SDK：与您的应用程序集成

使用 Toolbox SDK 将工具集成到您的应用程序中。可用的 SDK 如下：

• Python SDK
• JS/TS SDK
• Go SDK
• Java SDK

示例（Python）：

from toolbox_core import ToolboxClient

client = ToolboxClient("localhost:5000")
tools = client.list_tools()
print(tools)

更多详情，请参阅 SDK 文档。

附加功能

• 身份验证： 支持 IAM、OAuth2 和 API 密钥。
• 可观测性： 内置 OpenTelemetry 指标和追踪。
• 连接池： 高效管理数据库连接。
• 语义搜索： 支持对数据执行基于向量的搜索。
• NL2SQL： 将自然语言查询转换为 SQL。

版本控制

本项目遵循语义化版本控制。有关可用版本，请参阅 Releases 页面。

贡献

我们欢迎贡献！请参阅我们的贡献指南了解更多详情。

社区

加入我们的 Discord，提出问题、分享想法并获得支持。