--- title: "MCP 工具参考：mcp toolbox - MCP 工具 | 思行致远" canonical: "https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-mcp-toolbox/" dateModified: "2026-06-30" datePublished: "2026-06-30" --- 打开 AI·外脑目录 AI·外脑 [返回专栏首页](https://siyuanailab.com/knowledge/) × 站内搜索 ⌕ 主要栏目 - [AI 核心概念](https://siyuanailab.com/knowledge/ai-core/) - [工作流](https://siyuanailab.com/knowledge/workflows/) - [工具配置与选型](https://siyuanailab.com/knowledge/toolkits/) - [信源与标准](https://siyuanailab.com/knowledge/sources/) - [场景案例 待开发](https://siyuanailab.com/knowledge/scenarios/) - [职业与能力](https://siyuanailab.com/knowledge/career/) 专题 - [从这里开始](https://siyuanailab.com/knowledge/start/) - [获取与安装](https://siyuanailab.com/knowledge/install/) - [建设日志](https://siyuanailab.com/knowledge/ops/) [工作流子目录](https://siyuanailab.com/knowledge/workflows/) 基础设施层 - [浏览器自动化 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/browser-automation/) - [MCP 工具 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/) - [WF-006 MCP 工具参考：fastmcp](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-fastmcp/) - [WF-007 MCP 工具参考：Figma Context MCP](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-figma-context-mcp/) - [WF-008 MCP 工具参考：github mcp server](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-github-mcp-server/) - [WF-009 MCP 工具参考：mcp toolbox](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-mcp-toolbox/) - [WF-010 MCP 工具参考：servers](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-servers/) - [文件系统与本地执行 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/) - [API 网关与工具路由 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/) Skill 生产线 - [目标明确 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/goal-definition/) - [Skill 设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/skill-design/) - [代码实现 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/implementation/) - [测试评估 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/testing-evaluation/) Skill 参考库 - [写作与内容 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/writing-content/) - [研究与知识 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/research-knowledge/) - [沟通与协作 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/communication-collaboration/) - [产品与项目 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/product-project/) - [数据与分析 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/) - [创意与设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/creative-design/) - [商业与营销 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/business-marketing/) Agent Building 只收录有多步工作流、工作标准、Loop、Harness、工具链或通信机制的真 Agent；不收纯 persona、profile、curated list 或只有 system prompt 的仓库。 - [多 Agent 框架 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/multi-agent-frameworks/) - [工作流编排 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/workflow-orchestration/) - [Sub-agent 模式 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/sub-agent-patterns/) - [Harness 与评估 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/harness-evaluation/) 基础设施层 · MCP 工具 · 工具解读 · WF-009 # MCP 工具参考：mcp toolbox 思行致远 · 2026/6/30 · 置信度：高 MCP工具接口Agent工具协议生态 Google 开源的数据库 MCP server 和自定义工具框架，把数据库访问、预置工具、结构化查询和观测集中管理。 # MCP Toolbox for Databases > Google 开源的数据库 MCP server 和自定义工具框架，把数据库访问、预置工具、结构化查询和观测集中管理。 ## 这个能力解决什么问题 Agent 连接数据库最危险的点是把“随便执行 SQL”暴露给模型。MCP Toolbox for Databases 解决的是两层问题：一层是预置数据库工具，让 IDE/CLI 快速探索 schema、查询数据；另一层是自定义工具框架，让生产 Agent 只通过受限的结构化查询、语义搜索或 NL2SQL 工具访问数据库，并带连接池、认证和 OpenTelemetry。 ## 核心逻辑 输入可以是 MCP 客户端的自然语言数据库请求，也可以是应用通过 SDK 调用某个工具。Toolbox server 根据 `--prebuilt=` 或 `tools.yaml` 加载数据源、工具、toolsets 和 prompts；运行时根据工具定义连接 PostgreSQL、BigQuery、Cloud SQL、Spanner、MongoDB、Redis、Snowflake 等数据源，执行预定义 SQL/查询/语义搜索，并把结果返回给 MCP client 或应用 SDK。输出是表结构、查询结果、工具调用结果、trace/metrics。 ## 技术结构 - **Prebuilt Tools**：通过 `@toolbox-sdk/server --prebuilt=postgres` 等方式快速得到 `list_tables`、`execute_sql` 等数据库探索工具。 - **tools.yaml 配置**：`sources` 定义数据源，`tools` 定义动作和参数，`toolsets` 分组工具，`prompts` 提供可复用提示。 - **多数据库支持**：Google Cloud 数据库和 PostgreSQL/MySQL/Oracle/MongoDB/Redis/Elasticsearch/ClickHouse/Neo4j/Snowflake 等都有集成方向。 - **SDK 与 MCP 双入口**：既能接 Gemini CLI、Claude Code、Codex 等 MCP client，也有 Python/JS/Go/Java SDK 嵌入应用。 - **生产能力**：连接池、IAM/认证、OpenTelemetry metrics/tracing 是 README 明确强调的基础设施能力。 ## 为什么值得参考 它把数据库工具从“模型写 SQL”改成“工程师定义可调用工具”。`sources/tools/toolsets/prompts` 四段配置给了一个很好的安全模型：数据源和动作分离，工具可分组，提示可绑定业务语义。对企业 AI 服务来说，这比直接开放数据库连接字符串给 Agent 更可控。 ## 为什么不建议直接套用 预置工具虽然方便，但 `execute_sql` 这类通用能力在生产环境风险很高；需要数据库权限、只读账号、行列级权限和查询限额配合。多数据库支持也意味着配置复杂，某些高级能力和认证方式要逐个验证。若只是读一张小表，完整 Toolbox 可能比一个受限内部 API 重。 ## 如何改造成自己的版本 先用它的 `tools.yaml` 思路设计内部“数据工具契约”：每个工具只做一个白名单查询，参数必须强类型，默认只读，输出限制行数并脱敏。把通用 SQL 工具限制在开发/分析环境，生产 Agent 只拿 toolsets 中的业务工具。所有调用记录 user、tool、source、参数 hash、row count 和 latency，便于审计。 ## 适用场景 - Agent/IDE 需要安全探索或查询数据库。 - 多数据库、多团队需要统一工具配置和观测。 - 生产 Agent 需要受限结构化数据工具。 ## 不适用场景 - 想让模型自由写 SQL 操作生产库。 - 数据权限、脱敏、查询预算还没定义。 - 只有极简单数据读取，用内部 API 更轻。 ## 参考信息 - 原项目：[mcp-toolbox](https://github.com/googleapis/mcp-toolbox) - 作者：googleapis - 相关概念：[[数据库工具]]、[[MCP]]、[[结构化查询]] - 相关卡片：保守留空 ## 参考对象信息 **名称：**mcp-toolbox **作者：**googleapis **链接：**[https://github.com/googleapis/mcp-toolbox](https://github.com/googleapis/mcp-toolbox) ## 适用场景与行动 **场景：**基础设施层 / MCP 工具 **适合谁：**关注 AI 工作流、Skill 生产和 Agent Building 的读者 **下一步：**先阅读边界说明，再判断它是否适合改造成自己的MCP 工具流程。 当前内容按公开来源和已审核草稿整理，只作为工作流理解与方法论参考。 涉及客户数据、外部平台、会议记录和业务系统的场景，必须保留人工确认与授权边界。 [上一张：MCP 工具参考：github mcp server](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-github-mcp-server/) [下一张：MCP 工具参考：servers](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/infrastructure-mcp-tools-servers/) [返回当前分类](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/) [返回工作流专栏](https://siyuanailab.com/knowledge/workflows/)