【智能体架构】MCP数据库工具箱

简介

MCP Toolbox for Databases 简介

MCP Toolbox for Databases 是一个开源的数据库 MCP 服务端。它通过处理连接池、身份验证等复杂问题，帮助开发者更轻松、快速、安全地构建工具。

注意
本解决方案最初命名为 "Gen AI Toolbox for Databases"（因其开发早于 MCP 框架），现已更名以适配新增的 MCP 兼容特性。

为什么选择 Toolbox？

Toolbox 助力构建 Gen AI 工具，使您的智能体（Agents）能够访问数据库数据。Toolbox 提供：

• 开发简化：少于 10 行代码即可将工具集成至智能体，跨智能体或框架复用工具，更轻松部署工具新版本。
• 性能优化：内置连接池、身份验证等最佳实践。
• 安全增强：集成式身份验证保障数据访问安全。
• 端到端可观测性：开箱即用的指标与追踪功能，原生支持 OpenTelemetry。

⚡ 用 AI 数据库助手加速工作流 ⚡

停止上下文切换，让 AI 助手成为真正的协同开发者。通过 MCP Toolbox 连接 IDE 与数据库，您可将复杂耗时的数据库任务交由 AI 处理，从而提升开发效率专注核心事务。这不仅是代码补全——更是赋予 AI 处理全开发周期的上下文能力。

以下是它如何为您节省时间：

• 自然语言查询：在 IDE 中直接用英语与您的数据交互。无需编写 SQL，即可提出复杂问题，例如：“2024年交付了多少订单？包含哪些商品？”
• 自动化数据库管理：只需描述您的数据需求，AI 助手即可为您管理数据库。它可以处理生成查询、创建表、添加索引等操作。
• 生成上下文感知代码：让您的 AI 助手基于对实时数据库模式的深入理解，生成可直接使用的应用程序代码和测试。这通过确保生成的代码立即可用来加速开发周期。
• 削减开发开销：大幅减少手动设置和样板代码的时间。MCP Toolbox 有助于简化冗长的数据库配置、重复性代码和易出错的结构迁移。

了解如何通过 MCP 将您的 AI 工具（如 IDE）连接到 Toolbox。

系统架构

Toolbox 位于您的应用程序编排框架和数据库之间，提供一个用于修改、分发或调用工具的控制平面。它通过为您提供一个集中存储和更新工具的位置来简化工具管理，允许您在智能体和应用程序之间共享工具，并在无需重新部署应用程序的情况下更新这些工具。

快速入门

安装服务端

最新版本请查看发布页，并根据您的操作系统和 CPU 架构使用以下说明。

• 二进制文件
• 容器镜像
• 源码编译

安装 Toolbox 二进制文件：

其他版本见发布页

export VERSION=0.8.0
curl -O https://storage.googleapis.com/genai-toolbox/v

$VERSION/linux/amd64/toolbox
chmod +x toolbox

运行服务端

配置一个 tools.yaml 文件来定义您的工具，然后执行 toolbox 以启动服务端：
./toolbox --tools-file "tools.yaml"

注意
Toolbox 默认启用动态重载。要禁用，请使用 --disable-reload 标志。
您可以使用 toolbox help 查看所有标志的完整列表！要停止服务端，请发送终止信号（在大多数平台上为 ctrl+c）。
有关部署到不同环境的更详细文档，请查看操作指南部分中的资源。

集成您的应用程序

服务端启动并运行后，您可以将工具加载到您的应用程序中。以下是用于不同框架的客户端 SDK 列表：

Python

• Core
• LangChain
• Llamaindex
  安装 Toolbox Core SDK 后，您可以加载工具：
  from toolbox_core import ToolboxClient

将 url 更新为指向您的服务端

async with ToolboxClient("http://127.0.0.1

:5000") as client:
# 这些工具可以传递给您的应用程序！
tools = await client.load_toolset("toolset_name")
有关使用 Toolbox Core SDK 的更详细说明，请参阅项目的 README。

Javascript/Typescript

• Core
• LangChain/Langraph
• Genkit
• LlamaIndex
  安装 Toolbox Core SDK 后，您可以加载工具：
  import { ToolboxClient } from '@toolbox-sdk/core';
  // 将 url 更新为指向您的服务端
  const URL = 'http://127.0.0.1
  

  :5000';
  let client = new ToolboxClient(URL);
  // 这些工具可以传递给您的应用程序！
  const toolboxTools = await client.loadToolset('toolsetName');
  有关使用 Toolbox Core SDK 的更详细说明，请参阅项目的 README。