Repolode
googleapis

googleapis/mcp-toolbox

开源 MCP 服务器,让 AI 智能体、IDE 和应用安全连接各类数据库。

Star
16,681
Fork
1,765
未关闭 Issue
396
最近提交
3天前

这是什么?

MCP Toolbox for Databases 是一个开源的 Model Context Protocol(MCP)服务器,让 AI 智能体、IDE 助手和应用能够访问数据库。启动时加上 --prebuilt=postgres 等参数,Gemini CLI、Claude Code、Codex 等 MCP 客户端即可获得列出表、执行 SQL、查看表结构等通用工具。

面向生产环境时,它也可以作为自定义工具框架使用。开发者通过 tools.yaml 文件定义数据源、工具、工具集、提示词和资源,支持参数化 SQL 与访问限制。Python、JavaScript/TypeScript、Go 和 Java 的客户端 SDK 可以把这些工具接入 LangChain、LlamaIndex、Genkit、ADK 等框架。

项目支持 PostgreSQL、MySQL、BigQuery、Spanner、MongoDB、Redis、Elasticsearch、ClickHouse 等多种数据库。服务器内置连接池、基于 IAM 的认证以及 OpenTelemetry 指标与链路追踪,并提供用于测试工具的交互式 UI。

核心功能

  • 01为主流数据库提供开箱即用的通用工具,可在支持 MCP 的 IDE 和命令行中使用
  • 02通过 YAML 定义自定义工具,支持参数化 SQL、工具集和提示词
  • 03提供 Python、JavaScript/TypeScript、Go 和 Java 客户端 SDK
  • 04集成 IAM 认证并支持连接池
  • 05支持导出 OpenTelemetry 指标与链路追踪
  • 06提供交互式 UI 用于测试工具和工具集

适用场景

  • 让 AI 编程助手探索 PostgreSQL 或 MySQL 的表结构并生成与数据库相关的代码
  • 为生产环境智能体提供少量受限的参数化 SQL 工具,替代直接的数据库访问
  • 将 LangChain 或 LlamaIndex 智能体接入 BigQuery 或 Spanner 数据
  • 通过具名工具集向多个智能体提供数据库查询能力

快速上手

  1. 1

    在 MCP 客户端配置中添加 Toolbox 服务器

  2. 2

    使用配置文件运行 Toolbox 服务器

    npx @toolbox-sdk/server --config tools.yaml

使用前须知

  • 连接数据库需要设置连接环境变量或配置文件。
  • 通过 npx 运行以便捷为优先而非性能,生产环境建议使用二进制文件或容器镜像。

标签

常见问题

mcp-toolbox 是什么?
开源 MCP 服务器,让 AI 智能体、IDE 和应用安全连接各类数据库。 MCP Toolbox for Databases 是一个开源的 Model Context Protocol(MCP)服务器,让 AI 智能体、IDE 助手和应用能够访问数据库。启动时加上 --prebuilt=postgres 等参数,Gemini CLI、Claude Code、Codex 等 MCP 客户端即可获得列出表、执行 SQL、查看表结构等通用工具。
mcp-toolbox 可以免费使用吗?用的什么许可证?
mcp-toolbox 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
mcp-toolbox 还在维护吗?
活跃维护中。mcp-toolbox 最近一次提交是在 2026年10月17日。
mcp-toolbox 适合用来做什么?
让 AI 编程助手探索 PostgreSQL 或 MySQL 的表结构并生成与数据库相关的代码 为生产环境智能体提供少量受限的参数化 SQL 工具,替代直接的数据库访问 将 LangChain 或 LlamaIndex 智能体接入 BigQuery 或 Spanner 数据 通过具名工具集向多个智能体提供数据库查询能力
mcp-toolbox 怎么安装和运行?
在 MCP 客户端配置中添加 Toolbox 服务器 使用配置文件运行 Toolbox 服务器: npx @toolbox-sdk/server --config tools.yaml
在哪里获取 mcp-toolbox?
源代码和安装说明在 GitHub 上:https://github.com/googleapis/mcp-toolbox

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目