概述
MCP 数据库工具箱 是一个用于数据库的开源 MCP 服务器。它的设计考虑了企业级和生产质量要求。它通过处理连接池、身份验证等复杂性,使您能够更轻松、更快速、更安全地开发工具。 Toolbox 工具可以无缝集成到 LangChain 应用程序中。有关 入门 或 配置 MCP Toolbox 的更多信息,请参阅 文档。
设置
本指南假设您已经完成了以下操作:- 已安装 Python 3.9+ 和 pip。
- 已安装 PostgreSQL 16+ 和
psql命令行客户端。
1. 设置您的数据库
首先,让我们设置一个 PostgreSQL 数据库。我们将创建一个新数据库、MCP Toolbox 的专用用户以及带有示例数据的hotels 表。
使用 psql 命令连接到 PostgreSQL。您可能需要根据 PostgreSQL 设置调整命令(例如,如果需要指定主机或不同的超级用户)。
hotels 表并插入一些数据:
\q 退出 psql。
2. 安装 MCP 工具箱
接下来,我们将安装 MCP Toolbox,在tools.yaml 配置文件中定义我们的工具,并运行 MCP Toolbox 服务器。
对于 macOS 用户,最简单的方法是使用 Homebrew 安装:
tools.yaml 文件。此文件定义了 MCP Toolbox 可以连接的数据源以及它可以向您的代理暴露的工具。对于生产用途,请始终使用环境变量来存储机密信息。
toolbox。如果您手动下载了二进制文件,则需要从保存它的目录运行 ./toolbox:
http://127.0.0.1:5000 上启动,如果您更改 tools.yaml 文件,它将热重载。
实例化
调用
在代理中使用
现在到了有趣的部分!我们将安装所需的 LangChain 包并创建一个可以使用我们在 MCP Toolbox 中定义的工具的代理。ChatVertexAI 作为模型,并使用 ToolboxClient 加载我们的工具。langchain.agents 中的 create_agent 创建一个强大的代理,可以推理调用哪些工具。
注意: 在执行以下代码之前,请确保您的 MCP Toolbox 服务器正在单独的终端中运行。
运行代理
API 参考
此集成的主要类是ToolboxClient。
有关更多信息,请参阅以下资源:
MCP Toolbox 具有多种功能,使为数据库开发生成式 AI 工具变得无缝:
- 认证参数:将工具输入绑定到来自 OIDC 令牌的值的自动绑定,使得运行敏感查询而不会潜在泄露数据变得容易
- 授权调用:基于用户的 Auth token 限制对使用工具的访问
- OpenTelemetry:使用 OpenTelemetry 获取 MCP Toolbox 的指标和跟踪
社区与支持
我们鼓励您参与社区:- ⭐️ 前往 GitHub 仓库 开始并关注更新。
- 📚 深入阅读 官方文档 以获取更多高级功能和配置。
- 💬 加入我们的 Discord 服务器 以连接社区并提问。
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.

