MCP Toolbox for Databases 使用教程
1. 项目介绍
MCP Toolbox for Databases 是一个开源的 MCP 服务器,专为数据库设计,旨在支持企业级和产品级的使用。它能够帮助开发者更容易、更快、更安全地开发工具,通过处理连接池、认证等复杂性。
2. 项目快速启动
安装服务器
首先,根据你的操作系统和 CPU 架构,从发布页面获取最新版本,并按照以下说明进行操作。
二进制安装
要作为二进制安装 Toolbox:
export VERSION=0.3.0
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
chmod +x toolbox
容器镜像安装
你也可以将 Toolbox 作为容器安装:
export VERSION=0.3.0
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION
从源码编译
要从源码安装,确保你安装了最新版本的 Go,然后运行以下命令:
go install github.com/googleapis/genai-toolbox@v0.3.0
运行服务器
配置一个 tools.yaml 文件来定义你的工具,然后执行 toolbox 来启动服务器:
./toolbox --tools_file "tools.yaml"
使用 toolbox help 可获得所有标志的完整列表。要停止服务器,发送终止信号(大多数平台上是 ctrl+c)。
集成到应用中
一旦服务器运行,你可以将工具加载到你的应用中。以下是如何使用不同框架的客户端 SDK 的列表:
Core SDK
安装 Toolbox Core SDK:
pip install toolbox-core
加载工具:
from toolbox_core import ToolboxClient
client = ToolboxClient("http://127.0.0.1:5000")
tools = await client.load_toolset("toolset_name")
LangChain / LangGraph SDK
安装 Toolbox LangChain SDK:
pip install toolbox-langchain
加载工具:
from toolbox_langchain import ToolboxClient
client = ToolboxClient("http://127.0.0.1:5000")
tools = client.load_toolset()
LlamaIndex SDK
安装 Toolbox Llamaindex SDK:
pip install toolbox-llamaindex
加载工具:
from toolbox_llamaindex import ToolboxClient
client = ToolboxClient("http://127.0.0.1:5000")
tools = client.load_toolset()
3. 应用案例和最佳实践
- 简化开发:通过少于10行的代码将工具集成到你的代理中,跨多个代理或框架重用工具,并更容易地部署新版本的工具。
- 优化性能:采用最佳实践,如连接池、认证等。
- 增强安全性:集成的认证机制为数据访问提供更安全的保障。
- 端到端的可观察性:开箱即用的度量和跟踪,与内置的 OpenTelemetry 支持。
4. 典型生态项目
目前,MCP Toolbox for Databases 支持多种数据库源,并提供相应的工具集,以帮助开发者构建更加高效和安全的数据库交互应用。开源社区中也不断有新的项目涌现,为不同的应用场景提供解决方案。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



