[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-googleapis--genai-toolbox":3,"tool-googleapis--genai-toolbox":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",153609,2,"2026-04-13T11:34:59",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":76,"owner_website":77,"owner_url":78,"languages":79,"stars":108,"forks":109,"last_commit_at":110,"license":111,"difficulty_score":10,"env_os":112,"env_gpu":113,"env_ram":113,"env_deps":114,"category_tags":121,"github_topics":122,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":143,"updated_at":144,"faqs":145,"releases":161},7156,"googleapis\u002Fgenai-toolbox","genai-toolbox","MCP Toolbox for Databases is an open source MCP server for databases.","mcp-toolbox 是一款由谷歌开源的数据库连接中间件，旨在让 AI 助手、开发工具和企业应用能够安全、直接地访问数据库。它基于模型上下文协议（MCP）构建，有效解决了大语言模型在缺乏专用接口时难以可靠查询企业数据，以及开发者重复编写数据库对接代码的痛点。\n\n这款工具主要面向软件开发者和企业技术团队，同时也适合需要让 AI 代理具备数据操作能力的研究人员。其核心亮点在于“双重模式”设计：一方面提供开箱即用的通用工具，让用户无需编写额外代码即可通过自然语言指令探索表结构或执行 SQL 查询；另一方面提供强大的自定义框架，允许开发者定义受控的语义搜索或 NL2SQL（自然语言转 SQL）逻辑，确保生产环境下的数据安全与逻辑严谨。此外，mcp-toolbox 提供了涵盖 Python、JavaScript、Go 和 Java 的全方位 SDK，便于快速集成到各类现有系统中，是构建数据驱动型 AI 应用的理想基础设施。","\u003Cdiv align=\"center\">\n\n![logo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_703a7e4c8c19.png)\n\n# MCP Toolbox for Databases\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F13019\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_4a68feb902da.png\" alt=\"googleapis%2Fmcp-toolbox | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n[![Go Report Card](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_2b4a70945b89.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox)\n[![License: Apache\n2.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FApache-2.0)\n[![Docs](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-MCP_Toolbox-blue)](https:\u002F\u002Fmcp-toolbox.dev\u002F)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-%235865F2.svg?style=flat&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FDmm69peqjh)\n[![Medium](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMedium-12100E?style=flat&logo=medium&logoColor=white)](https:\u002F\u002Fmedium.com\u002F@mcp_toolbox)\n\n[![Python SDK](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Ftoolbox-core?logo=python&logoColor=white&label=Python%20SDK)](https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-core\u002F)\n[![JS\u002FTS SDK](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@toolbox-sdk\u002Fcore?logo=javascript&logoColor=white&label=JS%20SDK)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@toolbox-sdk\u002Fcore)\n[![Go SDK](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go?logo=go&logoColor=white&label=Go%20SDK)](https:\u002F\u002Fpkg.go.dev\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go)\n[![Java SDK](https:\u002F\u002Fimg.shields.io\u002Fmaven-central\u002Fv\u002Fcom.google.cloud.mcp\u002Fmcp-toolbox-sdk-java?logo=apache-maven&logoColor=white&label=Java%20SDK)](https:\u002F\u002Fmvnrepository.com\u002Fartifact\u002Fcom.google.cloud.mcp\u002Fmcp-toolbox-sdk-java)\n\u003C\u002Fdiv>\n\nMCP Toolbox for Databases is an open source Model Context Protocol (MCP) server that connects your AI agents, IDEs, and applications directly to your enterprise databases. \n\n\u003Cp align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_95dd65f57573.png\" alt=\"architecture\" width=\"50%\"\u002F>\n\u003C\u002Fp>\n\nIt serves a **dual purpose**:\n1. **Ready-to-use MCP Server (Build-Time):** Instantly connect Gemini CLI, Google Antigravity, Claude Code, Codex, or other MCP clients to your databases using our *prebuilt generic tools*. Talk to your data, explore schemas, and generate code without writing boilerplate.\n2. **Custom Tools Framework (Run-Time):** A robust framework to build specialized, highly secure AI tools for your production agents. Define structured queries, semantic search, and NL2SQL capabilities safely and easily.\n\n\nThis README provides a brief overview. For comprehensive details, see the [full documentation](https:\u002F\u002Fmcp-toolbox.dev\u002F).\n\n> [!IMPORTANT] \n> **Repository Name Update:** The `genai-toolbox` repository has been officially renamed to `mcp-toolbox`. To ensure your local environment reflects the new name, you may update your remote:\n> `git remote set-url origin https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox.git`\n\n> [!NOTE]\n> This solution was originally named “Gen AI Toolbox for Databases” (github.com\u002Fgoogleapis\u002Fmcp-toolbox) as its initial development predated MCP, but was renamed to align with the MCP compatibility.\n\n\u003C!-- TOC ignore:true -->\n## Table of Contents\n\n- [Why MCP Toolbox?](#why-mcp-toolbox)\n- [Quick Start: Prebuilt Tools](#quick-start-prebuilt-tools)\n- [Quick Start: Custom Tools](#quick-start-custom-tools)\n- [Install & Run the Toolbox server](#install--run-the-toolbox-server)\n- [Connect to Toolbox](#connect-to-toolbox)\n - [MCP Client](#mcp-client)\n - [Toolbox SDKs: Integrate with your Application](#toolbox-sdks-integrate-with-your-application)\n- [Additional Features](#additional-features)\n- [Versioning](#versioning)\n- [Contributing](#contributing)\n- [Community](#community)\n\n---\n\n## Why MCP Toolbox?\n\n- **Out-of-the-Box Database Access:** Prebuilt generic tools for instant data exploration (e.g., `list_tables`, `execute_sql`) directly from your IDE or CLI.\n- **Custom Tools Framework:** Build production-ready tools with your own predefined logic, ensuring safety through Restricted Access, Structured Queries, and Semantic Search.\n- **Simplified Development:** Integrate tools into your Agent Development Kit (ADK), LangChain, LlamaIndex, or custom agents in less than 10 lines of code.\n- **Better Performance:** Handles connection pooling, integrated auth (IAM), and end-to-end observability (OpenTelemetry) out of the box.\n- **Enhanced Security**: Integrated authentication for more secure access to your data.\n- **End-to-end Observability**: Out of the box metrics and tracing with built-in support for OpenTelemetry.\n\n---\n\n## Quick Start: Prebuilt Tools\n\nStop context-switching and let your AI assistant become a true co-developer. By connecting your IDE to your databases with MCP Toolbox, you can query your data in plain English, automate schema discovery and management, and generate database-aware code.\n\nYou can use the Toolbox in any MCP-compatible IDE or client (e.g., Gemini CLI, Google Antigravity, Claude Code, Codex, etc.) by configuring the MCP server.\n\n**Prebuilt tools are also conveniently available via the [Google Antigravity MCP Store](https:\u002F\u002Fantigravity.google\u002Fdocs\u002Fmcp) with a simple click-to-install experience.**\n\n1. Add the following to your client's MCP configuration file (usually `mcp.json` or `claude_desktop_config.json`):\n\n ```json\n {\n \"mcpServers\": {\n \"toolbox-postgres\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@toolbox-sdk\u002Fserver\",\n \"--prebuilt=postgres\"\n ]\n }\n }\n }\n ```\n\n2. Set the appropriate environment variables to connect, see the [Prebuilt Tools Reference](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fprebuilt-configs\u002F).\n\nWhen you run Toolbox with a `--prebuilt=\u003Cdatabase>` flag, you instantly get access to standard tools to interact with that database. \n\nSupported databases currently include:\n- **Google Cloud:** AlloyDB, BigQuery, Cloud SQL (PostgreSQL, MySQL, SQL Server), Spanner, Firestore, Knowledge Catalog (formerly known as Dataplex).\n- **Other Databases:** PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake, Trino, and more.\n\nFor a full list of available tools and their capabilities across all supported databases, see the [Prebuilt Tools Reference](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fprebuilt-configs\u002F).\n\n*See the [Install & Run the Toolbox server](#install--run-the-toolbox-server) section for different execution methods like Docker or binaries.*\n\n\n> [!TIP]\n> For users looking for a managed solution, [Google Cloud MCP Servers](https:\u002F\u002Fcloud.google.com\u002Fblog\u002Fproducts\u002Fdatabases\u002Fmanaged-mcp-servers-for-google-cloud-databases) \n> provide a managed MCP experience with prebuilt tools; you can [learn more about the differences here](https:\u002F\u002Fmcp-toolbox.dev\u002Fdev\u002Freference\u002Ffaq\u002F).\n\n---\n\n## Quick Start: Custom Tools\n\nToolbox can also be used as a framework for customized tools.\nThe primary way to configure Toolbox is through the `tools.yaml` file. If you\nhave multiple files, you can tell Toolbox which to load with the `--config\ntools.yaml` flag.\n\nYou can find more detailed reference documentation to all resource types in the\n[Resources](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002F).\n\n### Sources\n\nThe `sources` section of your `tools.yaml` defines what data sources your\nToolbox should have access to. Most tools will have at least one source to\nexecute against.\n\n```yaml\nkind: source\nname: my-pg-source\ntype: postgres\nhost: 127.0.0.1\nport: 5432\ndatabase: toolbox_db\nuser: toolbox_user\npassword: my-password\n```\n\nFor more details on configuring different types of sources, see the\n[Sources](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fsources\u002F).\n\n### Tools\n\nThe `tools` section of a `tools.yaml` define the actions an agent can take: what\ntype of tool it is, which source(s) it affects, what parameters it uses, etc.\n\n```yaml\nkind: tool\nname: search-hotels-by-name\ntype: postgres-sql\nsource: my-pg-source\ndescription: Search for hotels based on name.\nparameters:\n - name: name\n type: string\n description: The name of the hotel.\nstatement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\nFor more details on configuring different types of tools, see the\n[Tools](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Ftools\u002F).\n\n### Toolsets\n\nThe `toolsets` section of your `tools.yaml` allows you to define groups of tools\nthat you want to be able to load together. This can be useful for defining\ndifferent groups based on agent or application.\n\n```yaml\nkind: toolset\nname: my_first_toolset\ntools:\n - my_first_tool\n - my_second_tool\n---\nkind: toolset\nname: my_second_toolset\ntools:\n - my_second_tool\n - my_third_tool\n```\n\n### Prompts\n\nThe `prompts` section of a `tools.yaml` defines prompts that can be used for\ninteractions with LLMs.\n\n```yaml\nkind: prompt\nname: code_review\ndescription: \"Asks the LLM to analyze code quality and suggest improvements.\"\nmessages:\n - content: >\n Please review the following code for quality, correctness,\n and potential improvements: \\n\\n{{.code}}\narguments:\n - name: \"code\"\n description: \"The code to review\"\n```\n\nFor more details on configuring prompts, see the\n[Prompts](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fprompts\u002F).\n\n---\n\n## Install & Run the Toolbox server\n\nYou can run Toolbox directly with a [configuration file](#quick-start-custom-tools):\n\n```sh\nnpx @toolbox-sdk\u002Fserver --config tools.yaml\n```\n\nThis runs the latest version of the Toolbox server with your configuration file.\n\n> [!NOTE]\n> This method is optimized for convenience rather than performance. \n> For a more standard and reliable installation, please use the binary\n> or container image as described in [Install & Run the Toolbox server](#install--run-the-toolbox-server).\n\n### Install Toolbox\n\nFor the latest version, check the [releases page][releases] and use the\nfollowing instructions for your OS and CPU architecture.\n\n[releases]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Freleases\n\n\u003Cdetails open>\n\u003Csummary>Binary\u003C\u002Fsummary>\n\nTo install Toolbox as a binary:\n\n\u003C!-- {x-release-please-start-version} -->\n> \u003Cdetails>\n> \u003Csummary>Linux (AMD64)\u003C\u002Fsummary>\n>\n> To install Toolbox as a binary on Linux (AMD64):\n>\n> ```sh\n> # see releases page for other versions\n> export VERSION=1.0.0\n> curl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Flinux\u002Famd64\u002Ftoolbox\n> chmod +x toolbox\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>macOS (Apple Silicon)\u003C\u002Fsummary>\n>\n> To install Toolbox as a binary on macOS (Apple Silicon):\n>\n> ```sh\n> # see releases page for other versions\n> export VERSION=1.0.0\n> curl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fdarwin\u002Farm64\u002Ftoolbox\n> chmod +x toolbox\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>macOS (Intel)\u003C\u002Fsummary>\n>\n> To install Toolbox as a binary on macOS (Intel):\n>\n> ```sh\n> # see releases page for other versions\n> export VERSION=1.0.0\n> curl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fdarwin\u002Famd64\u002Ftoolbox\n> chmod +x toolbox\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>Windows (Command Prompt)\u003C\u002Fsummary>\n>\n> To install Toolbox as a binary on Windows (Command Prompt):\n>\n> ```cmd\n> :: see releases page for other versions\n> set VERSION=1.0.0\n> curl -o toolbox.exe \"https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv%VERSION%\u002Fwindows\u002Famd64\u002Ftoolbox.exe\"\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>Windows (PowerShell)\u003C\u002Fsummary>\n>\n> To install Toolbox as a binary on Windows (PowerShell):\n>\n> ```powershell\n> # see releases page for other versions\n> $VERSION = \"1.0.0\"\n> curl.exe -o toolbox.exe \"https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fwindows\u002Famd64\u002Ftoolbox.exe\"\n> ```\n>\n> \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Container image\u003C\u002Fsummary>\nYou can also install Toolbox as a container:\n\n```sh\n# see releases page for other versions\nexport VERSION=1.0.0\ndocker pull us-central1-docker.pkg.dev\u002Fdatabase-toolbox\u002Ftoolbox\u002Ftoolbox:$VERSION\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Homebrew\u003C\u002Fsummary>\n\nTo install Toolbox using Homebrew on macOS or Linux:\n\n```sh\nbrew install mcp-toolbox\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Compile from source\u003C\u002Fsummary>\n\nTo install from source, ensure you have the latest version of\n[Go installed](https:\u002F\u002Fgo.dev\u002Fdoc\u002Finstall), and then run the following command:\n\n```sh\ngo install github.com\u002Fgoogleapis\u002Fmcp-toolbox@v1.0.0\n```\n\u003C!-- {x-release-please-end} -->\n\n\u003C\u002Fdetails>\n\u003Cdetails>\n\u003Csummary>Gemini CLI\u003C\u002Fsummary>\nCheck out the [Gemini CLI extensions](https:\u002F\u002Fgeminicli.com\u002Fextensions\u002F) to install prebuilt tools for specific databases like AlloyDB, BigQuery, and Cloud SQL directly into Gemini CLI.\n\n```sh\n# Install Gemini CLI\nnpm install -g @google\u002Fgemini-cli\n# Install the extension\ngemini extensions install https:\u002F\u002Fgithub.com\u002Fgemini-cli-extensions\u002Fcloud-sql-postgres\n# Run Gemini CLI\ngemini\n```\n\nInteract with your custom tools using natural language through the Gemini CLI.\n\n```sh\n# Install the extension\ngemini extensions install https:\u002F\u002Fgithub.com\u002Fgemini-cli-extensions\u002Fmcp-toolbox\n```\n\u003C\u002Fdetails>\n\n\n### Run Toolbox\n\n[Configure](#quick-start-custom-tools) a `tools.yaml` to define your tools, and then\nexecute `toolbox` to start the server:\n\n\u003Cdetails open>\n\u003Csummary>Binary\u003C\u002Fsummary>\n\nTo run Toolbox from binary:\n\n```sh\n.\u002Ftoolbox --config \"tools.yaml\"\n```\n\n> ⓘ Note \n> Toolbox enables dynamic reloading by default. To disable, use the\n> `--disable-reload` flag.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\n\u003Csummary>Container image\u003C\u002Fsummary>\n\nTo run the server after pulling the [container image](#install-toolbox):\n\n```sh\nexport VERSION=0.24.0 # Use the version you pulled\ndocker run -p 5000:5000 \\\n-v $(pwd)\u002Ftools.yaml:\u002Fapp\u002Ftools.yaml \\\nus-central1-docker.pkg.dev\u002Fdatabase-toolbox\u002Ftoolbox\u002Ftoolbox:$VERSION \\\n--config \"\u002Fapp\u002Ftools.yaml\"\n```\n\n> ⓘ Note \n> The `-v` flag mounts your local `tools.yaml` into the container, and `-p` maps\n> the container's port `5000` to your host's port `5000`.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\n\u003Csummary>Source\u003C\u002Fsummary>\n\nTo run the server directly from source, navigate to the project root directory\nand run:\n\n```sh\ngo run .\n```\n\n> ⓘ Note \n> This command runs the project from source, and is more suitable for development\n> and testing. It does **not** compile a binary into your `$GOPATH`. If you want\n> to compile a binary instead, refer the [Developer\n> Documentation](.\u002FDEVELOPER.md#building-the-binary).\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\n\u003Csummary>Homebrew\u003C\u002Fsummary>\n\nIf you installed Toolbox using [Homebrew](https:\u002F\u002Fbrew.sh\u002F), the `toolbox`\nbinary is available in your system path. You can start the server with the same\ncommand:\n\n```sh\ntoolbox --config \"tools.yaml\"\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>NPM\u003C\u002Fsummary>\n\nTo run Toolbox directly without manually downloading the binary (requires Node.js):\n```sh\nnpx @toolbox-sdk\u002Fserver --config tools.yaml\n```\n\n\u003C\u002Fdetails>\n\u003Cdetails>\n\u003Csummary>Gemini CLI\u003C\u002Fsummary>\nAfter installing a [Gemini CLI extensions](https:\u002F\u002Fgeminicli.com\u002Fextensions\u002F), the prebuilt tools will be available during use.\n\n```sh\n# Run Gemini CLI\ngemini\n\n# List extensions\n\u002Fexttensions list\n# List MCP servers\n\u002Fmcp list\n```\n\n\u003C\u002Fdetails>\n\n\nYou can use `toolbox help` for a full list of flags! To stop the server, send a\nterminate signal (`ctrl+c` on most platforms).\n\nFor more detailed documentation on deploying to different environments, check\nout the resources in the [Deploy Toolbox\nsection](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fdeploy-to\u002F)\n\n---\n\n## Connect to Toolbox\n\nOnce your Toolbox server is up and running, you can load tools into your MCP-compatible client or\napplication. \n\n### MCP Client\n\nAdd the following configuration to your MCP client configuration:\n\n```json\n{\n \"mcpServers\": {\n \"toolbox\": {\n \"type\": \"http\",\n \"url\": \"http:\u002F\u002F127.0.0.1:5000\u002Fmcp\",\n }\n }\n}\n```\n\nIf you would like to connect to a specific toolset, replace url with \"http:\u002F\u002F127.0.0.1:5000\u002Fmcp\u002F{toolset_name}\".\n\n\n### Toolbox SDKs: Integrate with your Application\n\nToolbox Client SDKs provide the easy-to-use building blocks and advanced features for connecting your custom applications to the MCP Toolbox server. See below the list of Client SDKs for using various frameworks:\n\n\u003Cdetails open>\n \u003Csummary>Python (\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-python\">Github\u003C\u002Fa>)\u003C\u002Fsummary>\n \u003Cbr>\n \u003Cblockquote>\n\n \u003Cdetails open>\n \u003Csummary>Core\u003C\u002Fsummary>\n\n1. Install [Toolbox Core SDK][toolbox-core]:\n\n ```bash\n pip install toolbox-core\n ```\n\n1. Load tools:\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http:\u002F\u002F127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = await client.load_toolset(\"toolset_name\")\n ```\n\nFor more detailed instructions on using the Toolbox Core SDK, see the\n[project's README][toolbox-core-readme].\n\n[toolbox-core]: https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-core\u002F\n[toolbox-core-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-python\u002Ftree\u002Fmain\u002Fpackages\u002Ftoolbox-core\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LangChain \u002F LangGraph\u003C\u002Fsummary>\n\n1. Install [Toolbox LangChain SDK][toolbox-langchain]:\n\n ```bash\n pip install toolbox-langchain\n ```\n\n1. Load tools:\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http:\u002F\u002F127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = client.load_toolset()\n ```\n\n For more detailed instructions on using the Toolbox LangChain SDK, see the\n [project's README][toolbox-langchain-readme].\n\n [toolbox-langchain]: https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-langchain\u002F\n [toolbox-langchain-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-python\u002Fblob\u002Fmain\u002Fpackages\u002Ftoolbox-langchain\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LlamaIndex\u003C\u002Fsummary>\n\n1. Install [Toolbox Llamaindex SDK][toolbox-llamaindex]:\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n1. Load tools:\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http:\u002F\u002F127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = client.load_toolset()\n ```\n\n For more detailed instructions on using the Toolbox Llamaindex SDK, see the\n [project's README][toolbox-llamaindex-readme].\n\n [toolbox-llamaindex]: https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-llamaindex\u002F\n [toolbox-llamaindex-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox-llamaindex-python\u002Fblob\u002Fmain\u002FREADME.md\n\n \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fblockquote>\n\u003Cdetails>\n \u003Csummary>Javascript\u002FTypescript (\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-js\">Github\u003C\u002Fa>)\u003C\u002Fsummary>\n \u003Cbr>\n \u003Cblockquote>\n\n \u003Cdetails open>\n \u003Csummary>Core\u003C\u002Fsummary>\n\n1. Install [Toolbox Core SDK][toolbox-core-js]:\n\n ```bash\n npm install @toolbox-sdk\u002Fcore\n ```\n\n1. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fcore';\n\n \u002F\u002F update the url to point to your server\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n \u002F\u002F these tools can be passed to your application!\n const tools = await client.loadToolset('toolsetName');\n ```\n\n For more detailed instructions on using the Toolbox Core SDK, see the\n [project's README][toolbox-core-js-readme].\n\n [toolbox-core-js]: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@toolbox-sdk\u002Fcore\n [toolbox-core-js-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-js\u002Fblob\u002Fmain\u002Fpackages\u002Ftoolbox-core\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LangChain \u002F LangGraph\u003C\u002Fsummary>\n\n1. Install [Toolbox Core SDK][toolbox-core-js]:\n\n ```bash\n npm install @toolbox-sdk\u002Fcore\n ```\n\n2. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fcore';\n\n \u002F\u002F update the url to point to your server\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n \u002F\u002F these tools can be passed to your application!\n const toolboxTools = await client.loadToolset('toolsetName');\n\n \u002F\u002F Define the basics of the tool: name, description, schema and core logic\n const getTool = (toolboxTool) => tool(currTool, {\n name: toolboxTool.getName(),\n description: toolboxTool.getDescription(),\n schema: toolboxTool.getParamSchema()\n });\n\n \u002F\u002F Use these tools in your Langchain\u002FLangraph applications\n const tools = toolboxTools.map(getTool);\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>Genkit\u003C\u002Fsummary>\n\n1. Install [Toolbox Core SDK][toolbox-core-js]:\n\n ```bash\n npm install @toolbox-sdk\u002Fcore\n ```\n\n2. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fcore';\n import { genkit } from 'genkit';\n\n \u002F\u002F Initialise genkit\n const ai = genkit({\n plugins: [\n googleAI({\n apiKey: process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY\n })\n ],\n model: googleAI.model('gemini-2.0-flash'),\n });\n\n \u002F\u002F update the url to point to your server\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n \u002F\u002F these tools can be passed to your application!\n const toolboxTools = await client.loadToolset('toolsetName');\n\n \u002F\u002F Define the basics of the tool: name, description, schema and core logic\n const getTool = (toolboxTool) => ai.defineTool({\n name: toolboxTool.getName(),\n description: toolboxTool.getDescription(),\n schema: toolboxTool.getParamSchema()\n }, toolboxTool)\n\n \u002F\u002F Use these tools in your Genkit applications\n const tools = toolboxTools.map(getTool);\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>ADK\u003C\u002Fsummary>\n\n1. Install [Toolbox ADK SDK][toolbox-adk-js]:\n\n ```bash\n npm install @toolbox-sdk\u002Fadk\n ```\n\n2. Load tools:\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fadk';\n\n \u002F\u002F update the url to point to your server\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n \u002F\u002F these tools can be passed to your application!\n const tools = await client.loadToolset('toolsetName');\n ```\n\n For more detailed instructions on using the Toolbox ADK SDK, see the\n [project's README][toolbox-adk-js-readme].\n\n [toolbox-adk-js]: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@toolbox-sdk\u002Fadk\n [toolbox-adk-js-readme]:\n https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-js\u002Fblob\u002Fmain\u002Fpackages\u002Ftoolbox-adk\u002FREADME.md\n\n \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fblockquote>\n\u003Cdetails>\n \u003Csummary>Go (\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\">Github\u003C\u002Fa>)\u003C\u002Fsummary>\n \u003Cbr>\n \u003Cblockquote>\n\n \u003Cdetails>\n \u003Csummary>Core\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"context\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\";\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F Framework agnostic tools\n tools, err := client.LoadToolset(\"toolsetName\", ctx)\n }\n ```\n\n For more detailed instructions on using the Toolbox Go SDK, see the\n [project's README][toolbox-core-go-readme].\n\n [toolbox-go]: https:\u002F\u002Fpkg.go.dev\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\n [toolbox-core-go-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fblob\u002Fmain\u002Fcore\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LangChain Go\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding\u002Fjson\"\n\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"github.com\u002Ftmc\u002Flangchaingo\u002Fllms\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F Fetch the tool's input schema\n inputschema, err := tool.InputSchema()\n\n var paramsSchema map[string]any\n _ = json.Unmarshal(inputschema, ¶msSchema)\n\n \u002F\u002F Use this tool with LangChainGo\n langChainTool := llms.Tool{\n Type: \"function\",\n Function: &llms.FunctionDefinition{\n Name: tool.Name(),\n Description: tool.Description(),\n Parameters: paramsSchema,\n },\n }\n }\n\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>Genkit\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n import (\n \"context\"\n \"log\"\n\n \"github.com\u002Ffirebase\u002Fgenkit\u002Fgo\u002Fgenkit\"\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Ftbgenkit\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F Update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n g := genkit.Init(ctx)\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F Convert the tool using the tbgenkit package\n \u002F\u002F Use this tool with Genkit Go\n genkitTool, err := tbgenkit.ToGenkitTool(tool, g)\n if err != nil {\n log.Fatalf(\"Failed to convert tool: %v\\n\", err)\n }\n log.Printf(\"Successfully converted tool: %s\", genkitTool.Name())\n }\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>Go GenAI\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding\u002Fjson\"\n\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"google.golang.org\u002Fgenai\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F Update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F Fetch the tool's input schema\n inputschema, err := tool.InputSchema()\n\n var schema *genai.Schema\n _ = json.Unmarshal(inputschema, &schema)\n\n funcDeclaration := &genai.FunctionDeclaration{\n Name: tool.Name(),\n Description: tool.Description(),\n Parameters: schema,\n }\n\n \u002F\u002F Use this tool with Go GenAI\n genAITool := &genai.Tool{\n FunctionDeclarations: []*genai.FunctionDeclaration{funcDeclaration},\n }\n }\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>OpenAI Go\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding\u002Fjson\"\n\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n openai \"github.com\u002Fopenai\u002Fopenai-go\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F Update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F Fetch the tool's input schema\n inputschema, err := tool.InputSchema()\n\n var paramsSchema openai.FunctionParameters\n _ = json.Unmarshal(inputschema, ¶msSchema)\n\n \u002F\u002F Use this tool with OpenAI Go\n openAITool := openai.ChatCompletionToolParam{\n Function: openai.FunctionDefinitionParam{\n Name: tool.Name(),\n Description: openai.String(tool.Description()),\n Parameters: paramsSchema,\n },\n }\n\n }\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails open>\n \u003Csummary>ADK Go\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n1. Load tools:\n\n ```go\n package main\n\n import (\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Ftbadk\"\n \"context\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F Update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n client, err := tbadk.NewToolboxClient(URL)\n if err != nil {\n return fmt.Sprintln(\"Could not start Toolbox Client\", err)\n }\n\n \u002F\u002F Use this tool with ADK Go\n tool, err := client.LoadTool(\"toolName\", ctx)\n if err != nil {\n return fmt.Sprintln(\"Could not load Toolbox Tool\", err)\n }\n }\n ```\n\n For more detailed instructions on using the Toolbox Go SDK, see the\n [project's README][toolbox-core-go-readme].\n\n\n \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fblockquote>\n\u003C\u002Fdetails>\n\n---\n\n## Additional Features\n\n### Test tools with the Toolbox UI\n\nTo launch Toolbox's interactive UI, use the `--ui` flag. This allows you to test\ntools and toolsets with features such as authorized parameters. To learn more,\nvisit [Toolbox UI](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Ftoolbox-ui\u002F).\n\n```sh\n.\u002Ftoolbox --ui\n```\n\n### Telemetry\n\nToolbox emits traces and metrics via OpenTelemetry. Use `--telemetry-otlp=\u003Cendpoint>` \nto export to any OTLP-compatible backend like Google Cloud Monitoring, Agnost AI, or \nothers. See the [telemetry docs](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fmonitoring\u002Fexport_telemetry\u002F) for details.\n\n### Generate Agent Skills\n\nThe `skills-generate` command allows you to convert a **toolset** into an **Agent Skill** compatible with the [Agent Skill specification](https:\u002F\u002Fagentskills.io\u002Fspecification). This is useful for distributing tools as portable skill packages.\n\n```bash\ntoolbox --config tools.yaml skills-generate \\\n --name \"my-skill\" \\\n --toolset \"my_toolset\" \\\n --description \"A skill containing multiple tools\"\n```\n\nOnce generated, you can install the skill into the Gemini CLI:\n\n```bash\ngemini skills install .\u002Fskills\u002Fmy-skill\n```\n\nFor more details, see the [Generate Agent Skills guide](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fskills\u002F).\n\n---\n\n## Versioning\n\nMCP Toolbox for Databases follows [Semantic Versioning](https:\u002F\u002Fsemver.org\u002F).\n\nThe Public API includes the Toolbox Server (CLI, configuration manifests, and pre-built toolsets) and the Client SDKs.\n\n- **Major versions** are incremented for breaking changes, such as incompatible CLI or manifest changes.\n- **Minor versions** are incremented for new features, including modifications to pre-built toolsets or beta features.\n- **Patch versions** are incremented for backward-compatible bug fixes.\n\nFor more details, see our [Full Versioning Policy](https:\u002F\u002Fmcp-toolbox.dev\u002Freference\u002Fversioning\u002F).\n\n---\n\n## Contributing\n\nContributions are welcome. Please, see the [CONTRIBUTING](CONTRIBUTING.md) guide to get started. \n\nFor technical details on setting up a environment for developing on Toolbox itself, see the [DEVELOPER](DEVELOPER.md) guide.\n\nPlease note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Contributor Code of Conduct](CODE_OF_CONDUCT.md) for more information.\n\n---\n\n## Community\n\nJoin our [Discord community](https:\u002F\u002Fdiscord.gg\u002FGQrFB3Ec3W) to connect with our developers!\n","\u003Cdiv align=\"center\">\n\n![logo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_703a7e4c8c19.png)\n\n# 数据库专用 MCP 工具箱\n\n\u003Ca href=\"https:\u002F\u002Ftrendshift.io\u002Frepositories\u002F13019\" target=\"_blank\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_4a68feb902da.png\" alt=\"googleapis%2Fmcp-toolbox | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"\u002F>\u003C\u002Fa>\n\n[![Go Report Card](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_2b4a70945b89.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox)\n[![许可证：Apache\n2.0](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FApache-2.0)\n[![文档](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocs-MCP_Toolbox-blue)](https:\u002F\u002Fmcp-toolbox.dev\u002F)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-%235865F2.svg?style=flat&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002FDmm69peqjh)\n[![Medium](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMedium-12100E?style=flat&logo=medium&logoColor=white)](https:\u002F\u002Fmedium.com\u002F@mcp_toolbox)\n\n[![Python SDK](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Ftoolbox-core?logo=python&logoColor=white&label=Python%20SDK)](https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-core\u002F)\n[![JS\u002FTS SDK](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@toolbox-sdk\u002Fcore?logo=javascript&logoColor=white&label=JS%20SDK)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@toolbox-sdk\u002Fcore)\n[![Go SDK](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go?logo=go&logoColor=white&label=Go%20SDK)](https:\u002F\u002Fpkg.go.dev\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go)\n[![Java SDK](https:\u002F\u002Fimg.shields.io\u002Fmaven-central\u002Fv\u002Fcom.google.cloud.mcp\u002Fmcp-toolbox-sdk-java?logo=apache-maven&logoColor=white&label=Java%20SDK)](https:\u002F\u002Fmvnrepository.com\u002Fartifact\u002Fcom.google.cloud.mcp\u002Fmcp-toolbox-sdk-java)\n\u003C\u002Fdiv>\n\n数据库专用 MCP 工具箱是一个开源的模型上下文协议（MCP）服务器，可将您的 AI 代理、集成开发环境和应用程序直接连接到企业数据库。\n\n\u003Cp align=\"center\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_genai-toolbox_readme_95dd65f57573.png\" alt=\"architecture\" width=\"50%\"\u002F>\n\u003C\u002Fp>\n\n它具有**双重用途**：\n1. **开箱即用的 MCP 服务器（构建时）：** 使用我们*预构建的通用工具*，可立即将 Gemini CLI、Google Antigravity、Claude Code、Codex 或其他 MCP 客户端连接到您的数据库。无需编写样板代码，即可与数据对话、探索模式并生成代码。\n2. **自定义工具框架（运行时）：** 一个强大的框架，用于为您的生产代理构建专门且高度安全的 AI 工具。您可以安全且轻松地定义结构化查询、语义搜索和 NL2SQL 功能。\n\n\n本 README 提供简要概述。有关详细信息，请参阅[完整文档](https:\u002F\u002Fmcp-toolbox.dev\u002F)。\n\n> [!IMPORTANT] \n> **仓库名称更新：** `genai-toolbox` 仓库已正式更名为 `mcp-toolbox`。为确保本地环境反映新名称，您可能需要更新远程仓库地址：\n> `git remote set-url origin https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox.git`\n\n> [!NOTE]\n> 此解决方案最初名为“Gen AI 数据库工具箱”（github.com\u002Fgoogleapis\u002Fmcp-toolbox），因为其初始开发早于 MCP，但后来更名为与 MCP 兼容。\n\n\u003C!-- TOC ignore:true -->\n## 目录\n\n- [为什么选择 MCP 工具箱？](#why-mcp-toolbox)\n- [快速入门：预构建工具](#quick-start-prebuilt-tools)\n- [快速入门：自定义工具](#quick-start-custom-tools)\n- [安装并运行工具箱服务器](#install--run-the-toolbox-server)\n- [连接到工具箱](#connect-to-toolbox)\n - [MCP 客户端](#mcp-client)\n - [工具箱 SDK：与您的应用程序集成](#toolbox-sdks-integrate-with-your-application)\n- [附加功能](#additional-features)\n- [版本控制](#versioning)\n- [贡献](#contributing)\n- [社区](#community)\n\n---\n\n## 为什么选择 MCP 工具箱？\n\n- **开箱即用的数据库访问：** 预构建的通用工具可让您直接从 IDE 或 CLI 即时探索数据（例如 `list_tables`、`execute_sql`）。\n- **自定义工具框架：** 您可以使用自己的预定义逻辑构建生产就绪的工具，通过限制访问、结构化查询和语义搜索来确保安全性。\n- **简化开发：** 您只需不到 10 行代码，即可将工具集成到您的 Agent Development Kit (ADK)、LangChain、LlamaIndex 或自定义代理中。\n- **更佳性能：** 自带连接池管理、集成身份验证（IAM）以及端到端可观ability（OpenTelemetry）等功能。\n- **增强的安全性：** 集成的身份验证机制使您对数据的访问更加安全。\n- **端到端可观ability：** 自带指标和跟踪功能，并内置对 OpenTelemetry 的支持。\n\n---\n\n## 快速入门：预构建工具\n\n停止频繁切换上下文，让您的 AI 助手真正成为您的联合开发者。通过将您的 IDE 与数据库连接到 MCP 工具箱，您可以使用纯英文查询数据、自动化模式发现与管理，并生成具备数据库感知能力的代码。\n\n您可以通过配置 MCP 服务器，在任何兼容 MCP 的 IDE 或客户端（如 Gemini CLI、Google Antigravity、Claude Code、Codex 等）中使用该工具箱。\n\n**预构建工具也可通过[Google Antigravity 的 MCP 商店](https:\u002F\u002Fantigravity.google\u002Fdocs\u002Fmcp)便捷地获取，只需单击即可完成安装。**\n\n1. 将以下内容添加到您的客户端 MCP 配置文件中（通常为 `mcp.json` 或 `claude_desktop_config.json`）：\n\n ```json\n {\n \"mcpServers\": {\n \"toolbox-postgres\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@toolbox-sdk\u002Fserver\",\n \"--prebuilt=postgres\"\n ]\n }\n }\n }\n ```\n\n2. 设置适当的环境变量以进行连接，请参阅[预构建工具参考](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fprebuilt-configs\u002F)。\n\n当您使用 `--prebuilt=\u003Cdatabase>` 标志运行 Toolbox 时，您将立即获得用于与该数据库交互的标准工具。\n\n目前支持的数据库包括：\n- **Google Cloud：** AlloyDB、BigQuery、Cloud SQL（PostgreSQL、MySQL、SQL Server）、Spanner、Firestore、Knowledge Catalog（原名 Dataplex）。\n- **其他数据库：** PostgreSQL、MySQL、SQL Server、Oracle、MongoDB、Redis、Elasticsearch、CockroachDB、ClickHouse、Couchbase、Neo4j、Snowflake、Trino 等。\n\n有关所有支持数据库中可用工具及其功能的完整列表，请参阅[预构建工具参考](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fprebuilt-configs\u002F)。\n\n*有关 Docker 或二进制文件等不同执行方式，请参阅[安装并运行工具箱服务器](#install--run-the-toolbox-server)部分。*\n\n\n> [!TIP]\n> 对于希望使用托管解决方案的用户，[Google Cloud 的 MCP 服务器](https:\u002F\u002Fcloud.google.com\u002Fblog\u002Fproducts\u002Fdatabases\u002Fmanaged-mcp-servers-for-google-cloud-databases) 提供了带有预构建工具的托管 MCP 体验；您可[在此处了解更多差异](https:\u002F\u002Fmcp-toolbox.dev\u002Fdev\u002Freference\u002Ffaq\u002F)。\n\n---\n\n## 快速入门：自定义工具\n\nToolbox 也可以用作构建自定义工具的框架。\n配置 Toolbox 的主要方式是通过 `tools.yaml` 文件。如果有多个文件，你可以使用 `--config tools.yaml` 标志来指定要加载的文件。\n\n你可以在[资源](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002F)中找到所有资源类型的更详细参考文档。\n\n### 数据源\n\n`tools.yaml` 文件中的 `sources` 部分定义了 Toolbox 应该访问哪些数据源。大多数工具至少会有一个需要执行操作的数据源。\n\n```yaml\nkind: source\nname: my-pg-source\ntype: postgres\nhost: 127.0.0.1\nport: 5432\ndatabase: toolbox_db\nuser: toolbox_user\npassword: my-password\n```\n\n有关配置不同类型数据源的更多详细信息，请参阅[数据源](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fsources\u002F)。\n\n### 工具\n\n`tools.yaml` 文件中的 `tools` 部分定义了代理可以执行的操作：工具的类型、影响的数据源、使用的参数等。\n\n```yaml\nkind: tool\nname: search-hotels-by-name\ntype: postgres-sql\nsource: my-pg-source\ndescription: 根据名称搜索酒店。\nparameters:\n - name: name\n type: string\n description: 酒店的名称。\nstatement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\n有关配置不同类型工具的更多详细信息，请参阅[工具](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Ftools\u002F)。\n\n### 工具集\n\n`tools.yaml` 文件中的 `toolsets` 部分允许你定义一组可以一起加载的工具。这对于根据代理或应用程序定义不同的组非常有用。\n\n```yaml\nkind: toolset\nname: my_first_toolset\ntools:\n - my_first_tool\n - my_second_tool\n---\nkind: toolset\nname: my_second_toolset\ntools:\n - my_second_tool\n - my_third_tool\n```\n\n### 提示词\n\n`tools.yaml` 文件中的 `prompts` 部分定义了可用于与 LLM 交互的提示词。\n\n```yaml\nkind: prompt\nname: code_review\ndescription: “请求 LLM 分析代码质量并提出改进建议。”\nmessages:\n - content: >\n 请审查以下代码的质量、正确性以及潜在的改进之处：\\n\\n{{.code}}\narguments:\n - name: \"code\"\n description: \"待审查的代码\"\n```\n\n有关配置提示词的更多详细信息，请参阅[提示词](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fprompts\u002F)。\n\n---\n\n## 安装并运行 Toolbox 服务器\n\n你可以直接使用[配置文件](#quick-start-custom-tools)来运行 Toolbox：\n\n```sh\nnpx @toolbox-sdk\u002Fserver --config tools.yaml\n```\n\n这将使用你的配置文件运行最新版本的 Toolbox 服务器。\n\n> [!注意]\n> 此方法更注重便捷性而非性能。若需更标准、更可靠的安装方式，请按照[安装并运行 Toolbox 服务器](#install--run-the-toolbox-server)中的说明使用二进制文件或容器镜像。\n\n### 安装 Toolbox\n\n要获取最新版本，请查看[发布页面][releases]，并根据你的操作系统和 CPU 架构使用以下说明。\n\n[releases]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Freleases\n\n\u003Cdetails open>\n\u003Csummary>二进制文件\u003C\u002Fsummary>\n\n以二进制文件形式安装 Toolbox：\n\n\u003C!-- {x-release-please-start-version} -->\n> \u003Cdetails>\n> \u003Csummary>Linux (AMD64)\u003C\u002Fsummary>\n>\n> 在 Linux (AMD64) 上以二进制文件形式安装 Toolbox：\n>\n> ```sh\n> # 其他版本请参见发布页面\n> export VERSION=1.0.0\n> curl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Flinux\u002Famd64\u002Ftoolbox\n> chmod +x toolbox\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>macOS (Apple Silicon)\u003C\u002Fsummary>\n>\n> 在 macOS (Apple Silicon) 上以二进制文件形式安装 Toolbox：\n>\n> ```sh\n> # 其他版本请参见发布页面\n> export VERSION=1.0.0\n> curl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fdarwin\u002Farm64\u002Ftoolbox\n> chmod +x toolbox\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>macOS (Intel)\u003C\u002Fsummary>\n>\n> 在 macOS (Intel) 上以二进制文件形式安装 Toolbox：\n>\n> ```sh\n> # 其他版本请参见发布页面\n> export VERSION=1.0.0\n> curl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fdarwin\u002Famd64\u002Ftoolbox\n> chmod +x toolbox\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>Windows (命令提示符)\u003C\u002Fsummary>\n>\n> 在 Windows (命令提示符) 上以二进制文件形式安装 Toolbox：\n>\n> ```cmd\n> :: 其他版本请参见发布页面\n> set VERSION=1.0.0\n> curl -o toolbox.exe \"https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv%VERSION%\u002Fwindows\u002Famd64\u002Ftoolbox.exe\"\n> ```\n>\n> \u003C\u002Fdetails>\n> \u003Cdetails>\n> \u003Csummary>Windows (PowerShell)\u003C\u002Fsummary>\n>\n> 在 Windows (PowerShell) 上以二进制文件形式安装 Toolbox：\n>\n> ```powershell\n> # 其他版本请参见发布页面\n> $VERSION = \"1.0.0\"\n> curl.exe -o toolbox.exe \"https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fwindows\u002Famd64\u002Ftoolbox.exe\"\n> ```\n>\n> \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>容器镜像\u003C\u002Fsummary>\n你也可以通过容器安装 Toolbox：\n\n```sh\n# 其他版本请参见发布页面\nexport VERSION=1.0.0\ndocker pull us-central1-docker.pkg.dev\u002Fdatabase-toolbox\u002Ftoolbox\u002Ftoolbox:$VERSION\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>Homebrew\u003C\u002Fsummary>\n\n在 macOS 或 Linux 上使用 Homebrew 安装 Toolbox：\n\n```sh\nbrew install mcp-toolbox\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>从源码编译\u003C\u002Fsummary>\n\n要从源码安装，请确保已安装最新版本的 [Go](https:\u002F\u002Fgo.dev\u002Fdoc\u002Finstall)，然后运行以下命令：\n\n```sh\ngo install github.com\u002Fgoogleapis\u002Fmcp-toolbox@v1.0.0\n```\n\u003C!-- {x-release-please-end} -->\n\n\u003C\u002Fdetails>\n\u003Cdetails>\n\u003Csummary>Gemini CLI\u003C\u002Fsummary>\n查看[Gemini CLI 扩展](https:\u002F\u002Fgeminicli.com\u002Fextensions\u002F)，可将针对 AlloyDB、BigQuery 和 Cloud SQL 等特定数据库的预构建工具直接安装到 Gemini CLI 中。\n\n```sh\n# 安装 Gemini CLI\nnpm install -g @google\u002Fgemini-cli\n# 安装扩展\ngemini extensions install https:\u002F\u002Fgithub.com\u002Fgemini-cli-extensions\u002Fcloud-sql-postgres\n# 运行 Gemini CLI\ngemini\n```\n\n通过 Gemini CLI 使用自然语言与你的自定义工具进行交互。\n\n```sh\n# 安装扩展\ngemini extensions install https:\u002F\u002Fgithub.com\u002Fgemini-cli-extensions\u002Fmcp-toolbox\n```\n\u003C\u002Fdetails>\n\n### 运行 Toolbox\n\n[配置](#quick-start-custom-tools) 一个 `tools.yaml` 文件来定义你的工具，然后执行 `toolbox` 命令启动服务器：\n\n\u003Cdetails open>\n\u003Csummary>二进制文件\u003C\u002Fsummary>\n\n从二进制文件运行 Toolbox：\n\n```sh\n.\u002Ftoolbox --config \"tools.yaml\"\n```\n\n> ⓘ 注意 \n> Toolbox 默认启用动态重载功能。如需禁用，请使用 `--disable-reload` 标志。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\n\u003Csummary>容器镜像\u003C\u002Fsummary>\n\n拉取 [容器镜像](#install-toolbox) 后，运行以下命令启动服务器：\n\n```sh\nexport VERSION=0.24.0 # 使用你拉取的版本\ndocker run -p 5000:5000 \\\n-v $(pwd)\u002Ftools.yaml:\u002Fapp\u002Ftools.yaml \\\nus-central1-docker.pkg.dev\u002Fdatabase-toolbox\u002Ftoolbox\u002Ftoolbox:$VERSION \\\n--config \"\u002Fapp\u002Ftools.yaml\"\n```\n\n> ⓘ 注意 \n> `-v` 标志会将本地的 `tools.yaml` 挂载到容器中，而 `-p` 则将容器的端口 `5000` 映射到主机的端口 `5000`。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\n\u003Csummary>源代码\u003C\u002Fsummary>\n\n若要直接从源代码运行服务器，请导航到项目根目录并执行：\n\n```sh\ngo run .\n```\n\n> ⓘ 注意 \n> 此命令会直接从源代码运行项目，更适合开发和测试。它**不会**编译出二进制文件并放置到你的 `$GOPATH` 中。如果你想编译二进制文件，请参阅 [开发者文档](.\u002FDEVELOPER.md#building-the-binary)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\n\u003Csummary>Homebrew\u003C\u002Fsummary>\n\n如果你使用 [Homebrew](https:\u002F\u002Fbrew.sh\u002F) 安装了 Toolbox，`toolbox` 二进制文件将位于系统的 PATH 中。你可以使用相同的命令启动服务器：\n\n```sh\ntoolbox --config \"tools.yaml\"\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>NPM\u003C\u002Fsummary>\n\n若想直接运行 Toolbox 而无需手动下载二进制文件（需要 Node.js）：\n\n```sh\nnpx @toolbox-sdk\u002Fserver --config tools.yaml\n```\n\n\u003C\u002Fdetails>\n\u003Cdetails>\n\u003Csummary>Gemini CLI\u003C\u002Fsummary>\n安装 [Gemini CLI 扩展](https:\u002F\u002Fgeminicli.com\u002Fextensions\u002F) 后，在使用过程中即可访问预构建的工具集。\n\n```sh\n# 运行 Gemini CLI\ngemini\n\n# 列出扩展\n\u002Fexttensions list\n# 列出 MCP 服务器\n\u002Fmcp list\n```\n\n\u003C\u002Fdetails>\n\n\n你可以使用 `toolbox help` 查看完整的标志列表！要停止服务器，只需发送终止信号（在大多数平台上为 `ctrl+c`）。\n\n有关在不同环境中部署的更详细文档，请参阅 [部署 Toolbox](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fdeploy-to\u002F) 部分中的资源。\n\n---\n\n## 连接到 Toolbox\n\n一旦你的 Toolbox 服务器启动并运行，你就可以将工具加载到兼容 MCP 的客户端或应用程序中。\n\n### MCP 客户端\n\n在你的 MCP 客户端配置中添加以下内容：\n\n```json\n{\n \"mcpServers\": {\n \"toolbox\": {\n \"type\": \"http\",\n \"url\": \"http:\u002F\u002F127.0.0.1:5000\u002Fmcp\",\n }\n }\n}\n```\n\n如果你想连接到特定的工具集，可以将 URL 替换为 `http:\u002F\u002F127.0.0.1:5000\u002Fmcp\u002F{toolset_name}`。\n\n### Toolbox SDK：集成到你的应用\n\nToolbox 客户端 SDK 提供了易于使用的构建模块和高级功能，可帮助你将自定义应用程序连接到 MCP Toolbox 服务器。以下是针对不同框架的客户端 SDK 列表：\n\n\u003Cdetails open>\n \u003Csummary>Python（\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-python\">Github\u003C\u002Fa>)\u003C\u002Fsummary>\n \u003Cbr>\n \u003Cblockquote>\n\n \u003Cdetails open>\n \u003Csummary>核心 SDK\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Core SDK][toolbox-core]：\n\n ```bash\n pip install toolbox-core\n ```\n\n1. 加载工具：\n\n ```python\n from toolbox_core import ToolboxClient\n\n # 将 URL 更新为指向你的服务器\n async with ToolboxClient(\"http:\u002F\u002F127.0.0.1:5000\") as client:\n\n # 这些工具可以传递给你的应用程序！\n tools = await client.load_toolset(\"toolset_name\")\n ```\n\n有关使用 Toolbox Core SDK 的更多详细说明，请参阅项目的 [README][toolbox-core-readme]。\n\n[toolbox-core]: https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-core\u002F\n[toolbox-core-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-python\u002Ftree\u002Fmain\u002Fpackages\u002Ftoolbox-core\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LangChain \u002F LangGraph\u003C\u002Fsummary>\n\n1. 安装 [Toolbox LangChain SDK][toolbox-langchain]：\n\n ```bash\n pip install toolbox-langchain\n ```\n\n1. 加载工具：\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # 将 URL 更新为指向你的服务器\n async with ToolboxClient(\"http:\u002F\u002F127.0.0.1:5000\") as client:\n\n # 这些工具可以传递给你的应用程序！\n tools = client.load_toolset()\n ```\n\n有关使用 Toolbox LangChain SDK 的更多详细说明，请参阅项目的 [README][toolbox-langchain-readme]。\n\n[toolbox-langchain]: https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-langchain\u002F\n[toolbox-langchain-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-python\u002Fblob\u002Fmain\u002Fpackages\u002Ftoolbox-langchain\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LlamaIndex\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Llamaindex SDK][toolbox-llamaindex]：\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n1. 加载工具：\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # 将 URL 更新为指向你的服务器\n async with ToolboxClient(\"http:\u002F\u002F127.0.0.1:5000\") as client:\n\n # 这些工具可以传递给你的应用程序！\n tools = client.load_toolset()\n ```\n\n有关使用 Toolbox Llamaindex SDK 的更多详细说明，请参阅项目的 [README][toolbox-llamaindex-readme]。\n\n[toolbox-llamaindex]: https:\u002F\u002Fpypi.org\u002Fproject\u002Ftoolbox-llamaindex\u002F\n[toolbox-llamaindex-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox-llamaindex-python\u002Fblob\u002Fmain\u002FREADME.md\n\n \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fblockquote>\n\u003Cdetails>\n \u003Csummary>Javascript\u002FTypescript（\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-js\">Github\u003C\u002Fa>)\u003C\u002Fsummary>\n \u003Cbr>\n \u003Cblockquote>\n\n \u003Cdetails open>\n \u003Csummary>核心 SDK\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Core SDK][toolbox-core-js]：\n\n ```bash\n npm install @toolbox-sdk\u002Fcore\n ```\n\n1. 加载工具：\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fcore';\n\n \u002F\u002F 将 URL 更新为指向你的服务器\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n \u002F\u002F 这些工具可以传递给你的应用程序！\n const tools = await client.load_toolset('toolsetName');\n ```\n\n有关使用 Toolbox Core SDK 的更多详细说明，请参阅项目的 [README][toolbox-core-js-readme]。\n\n[toolbox-core-js]: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@toolbox-sdk\u002Fcore\n[toolbox-core-js-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-js\u002Fblob\u002Fmain\u002Fpackages\u002Ftoolbox-core\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LangChain \u002F LangGraph\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Core SDK][toolbox-core-js]：\n\n ```bash\n npm install @toolbox-sdk\u002Fcore\n ```\n\n2. 加载工具：\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fcore';\n\n \u002F\u002F 将 URL 更新为指向你的服务器\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n\u002F\u002F 这些工具可以传递给您的应用！\n const toolboxTools = await client.loadToolset('toolsetName');\n\n \u002F\u002F 定义工具的基本信息：名称、描述、参数 schema 和核心逻辑\n const getTool = (toolboxTool) => tool(currTool, {\n name: toolboxTool.getName(),\n description: toolboxTool.getDescription(),\n schema: toolboxTool.getParamSchema()\n });\n\n \u002F\u002F 在您的 Langchain\u002FLanggraph 应用中使用这些工具\n const tools = toolboxTools.map(getTool);\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>Genkit\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Core SDK][toolbox-core-js]：\n\n ```bash\n npm install @toolbox-sdk\u002Fcore\n ```\n\n2. 加载工具：\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fcore';\n import { genkit } from 'genkit';\n\n \u002F\u002F 初始化 genkit\n const ai = genkit({\n plugins: [\n googleAI({\n apiKey: process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY\n })\n ],\n model: googleAI.model('gemini-2.0-flash'),\n });\n\n \u002F\u002F 将 URL 更新为指向您的服务器\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n \u002F\u002F 这些工具可以传递给您的应用！\n const toolboxTools = await client.loadToolset('toolsetName');\n\n \u002F\u002F 定义工具的基本信息：名称、描述、参数 schema 和核心逻辑\n const getTool = (toolboxTool) => ai.defineTool({\n name: toolboxTool.getName(),\n description: toolboxTool.getDescription(),\n schema: toolboxTool.getParamSchema()\n }, toolboxTool)\n\n \u002F\u002F 在您的 Genkit 应用中使用这些工具\n const tools = toolboxTools.map(getTool);\n ```\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>ADK\u003C\u002Fsummary>\n\n1. 安装 [Toolbox ADK SDK][toolbox-adk-js]：\n\n ```bash\n npm install @toolbox-sdk\u002Fadk\n ```\n\n2. 加载工具：\n\n ```javascript\n import { ToolboxClient } from '@toolbox-sdk\u002Fadk';\n\n \u002F\u002F 将 URL 更新为指向您的服务器\n const URL = 'http:\u002F\u002F127.0.0.1:5000';\n let client = new ToolboxClient(URL);\n\n \u002F\u002F 这些工具可以传递给您的应用！\n const tools = await client.loadToolset('toolsetName');\n ```\n\n 有关 Toolbox ADK SDK 的更详细使用说明，请参阅\n [项目的 README 文件][toolbox-adk-js-readme]。\n\n [toolbox-adk-js]: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@toolbox-sdk\u002Fadk\n [toolbox-adk-js-readme]:\n https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-js\u002Fblob\u002Fmain\u002Fpackages\u002Ftoolbox-adk\u002FREADME.md\n\n \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fblockquote>\n\u003Cdetails>\n \u003Csummary>Go (\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\">Github\u003C\u002Fa>)\u003C\u002Fsummary>\n \u003Cbr>\n \u003Cblockquote>\n\n \u003Cdetails>\n \u003Csummary>Core\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Go SDK][toolbox-go]：\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. 加载工具：\n\n ```go\n package main\n\n import (\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"context\"\n )\n\n func main() {\n \u002F\u002F 务必添加错误检查\n \u002F\u002F 将 URL 更新为指向您的服务器\n URL := \"http:\u002F\u002F127.0.0.1:5000\";\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F 框架无关的工具\n tools, err := client.LoadToolset(\"toolsetName\", ctx)\n }\n ```\n\n 有关 Toolbox Go SDK 的更详细使用说明，请参阅\n [项目的 README 文件][toolbox-core-go-readme]。\n\n [toolbox-go]: https:\u002F\u002Fpkg.go.dev\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\n [toolbox-core-go-readme]: https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fblob\u002Fmain\u002Fcore\u002FREADME.md\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>LangChain Go\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Go SDK][toolbox-go]：\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. 加载工具：\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding\u002Fjson\"\n\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"github.com\u002Ftmc\u002Flangchaingo\u002Fllms\"\n )\n\n func main() {\n \u002F\u002F 务必添加错误检查\n \u002F\u002F 将 URL 更新为指向您的服务器\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F 框架无关的工具\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F 获取工具的输入 schema\n inputschema, err := tool.InputSchema()\n\n var paramsSchema map[string]any\n _ = json.Unmarshal(inputschema, ¶msSchema)\n\n \u002F\u002F 在 LangChainGo 中使用此工具\n langChainTool := llms.Tool{\n Type: \"function\",\n Function: &llms.FunctionDefinition{\n Name: tool.Name(),\n Description: tool.Description(),\n Parameters: paramsSchema,\n },\n }\n }\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>Genkit\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Go SDK][toolbox-go]：\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. 加载工具：\n\n ```go\n package main\n import (\n \"context\"\n \"log\"\n\n \"github.com\u002Ffirebase\u002Fgenkit\u002Fgo\u002Fgenkit\"\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Ftbgenkit\"\n )\n\n func main() {\n \u002F\u002F 务必添加错误检查\n \u002F\u002F 将 URL 更新为指向您的服务器\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n g := genkit.Init(ctx)\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F 框架无关的工具\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F 使用 tbgenkit 包将工具转换\n \u002F\u002F 在 Genkit Go 中使用此工具\n genkitTool, err := tbgenkit.ToGenkitTool(tool, g)\n if err != nil {\n log.Fatalf(\"工具转换失败：%v\\n\", err)\n }\n log.Printf(\"工具成功转换： %s\", genkitTool.Name())\n }\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>Go GenAI\u003C\u002Fsummary>\n\n1. 安装 [Toolbox Go SDK][toolbox-go]：\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. 加载工具：\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding\u002Fjson\"\n\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n \"google.golang.org\u002Fgenai\"\n )\n\n func main() {\n \u002F\u002F 务必添加错误检查\n \u002F\u002F 将 URL 更新为指向您的服务器\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F 框架无关的工具\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F 获取工具的输入 schema\n inputschema, err := tool.InputSchema()\n\n var schema *genai.Schema\n _ = json.Unmarshal(inputschema, &schema)\n\n funcDeclaration := &genai.FunctionDeclaration{\n Name: tool.Name(),\n Description: tool.Description(),\n Parameters: schema,\n }\n }\n ```\n\n\u002F\u002F Use this tool with Go GenAI\n genAITool := &genai.Tool{\n FunctionDeclarations: []*genai.FunctionDeclaration{funcDeclaration},\n }\n }\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails>\n \u003Csummary>OpenAI Go\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n2. Load tools:\n\n ```go\n package main\n\n import (\n \"context\"\n \"encoding\u002Fjson\"\n\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Fcore\"\n openai \"github.com\u002Fopenai\u002Fopenai-go\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F Update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n\n client, err := core.NewToolboxClient(URL)\n\n \u002F\u002F Framework agnostic tool\n tool, err := client.LoadTool(\"toolName\", ctx)\n\n \u002F\u002F Fetch the tool's input schema\n inputschema, err := tool.InputSchema()\n\n var paramsSchema openai.FunctionParameters\n _ = json.Unmarshal(inputschema, ¶msSchema)\n\n \u002F\u002F Use this tool with OpenAI Go\n openAITool := openai.ChatCompletionToolParam{\n Function: openai.FunctionDefinitionParam{\n Name: tool.Name(),\n Description: openai.String(tool.Description()),\n Parameters: paramsSchema,\n },\n }\n\n }\n ```\n\n \u003C\u002Fdetails>\n \u003Cdetails open>\n \u003Csummary>ADK Go\u003C\u002Fsummary>\n\n1. Install [Toolbox Go SDK][toolbox-go]:\n\n ```bash\n go get github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\n ```\n\n1. Load tools:\n\n ```go\n package main\n\n import (\n \"github.com\u002Fgoogleapis\u002Fmcp-toolbox-sdk-go\u002Ftbadk\"\n \"context\"\n )\n\n func main() {\n \u002F\u002F Make sure to add the error checks\n \u002F\u002F Update the url to point to your server\n URL := \"http:\u002F\u002F127.0.0.1:5000\"\n ctx := context.Background()\n client, err := tbadk.NewToolboxClient(URL)\n if err != nil {\n return fmt.Sprintln(\"Could not start Toolbox Client\", err)\n }\n\n \u002F\u002F Use this tool with ADK Go\n tool, err := client.LoadTool(\"toolName\", ctx)\n if err != nil {\n return fmt.Sprintln(\"Could not load Toolbox Tool\", err)\n }\n }\n ```\n\n For more detailed instructions on using the Toolbox Go SDK, see the\n [project's README][toolbox-core-go-readme].\n\n\n \u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fblockquote>\n\u003C\u002Fdetails>\n\n---\n\n\n\n## Additional Features\n\n### Test tools with the Toolbox UI\n\nTo launch Toolbox's interactive UI, use the `--ui` flag. This allows you to test\ntools and toolsets with features such as authorized parameters. To learn more,\nvisit [Toolbox UI](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Ftoolbox-ui\u002F).\n\n```sh\n.\u002Ftoolbox --ui\n```\n\n### Telemetry\n\nToolbox emits traces and metrics via OpenTelemetry. Use `--telemetry-otlp=\u003Cendpoint>` \nto export to any OTLP-compatible backend like Google Cloud Monitoring, Agnost AI, or \nothers. See the [telemetry docs](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fmonitoring\u002Fexport_telemetry\u002F) for details.\n\n### Generate Agent Skills\n\nThe `skills-generate` command allows you to convert a **toolset** into an **Agent Skill** compatible with the [Agent Skill specification](https:\u002F\u002Fagentskills.io\u002Fspecification). This is useful for distributing tools as portable skill packages.\n\n```bash\ntoolbox --config tools.yaml skills-generate \\\n --name \"my-skill\" \\\n --toolset \"my_toolset\" \\\n --description \"A skill containing multiple tools\"\n```\n\nOnce generated, you can install the skill into the Gemini CLI:\n\n```bash\ngemini skills install .\u002Fskills\u002Fmy-skill\n```\n\nFor more details, see the [Generate Agent Skills guide](https:\u002F\u002Fmcp-toolbox.dev\u002Fdocumentation\u002Fconfiguration\u002Fskills\u002F).\n\n---\n\n## Versioning\n\nMCP Toolbox for Databases follows [Semantic Versioning](https:\u002F\u002Fsemver.org\u002F).\n\nThe Public API includes the Toolbox Server (CLI, configuration manifests, and pre-built toolsets) and the Client SDKs.\n\n- **Major versions** are incremented for breaking changes, such as incompatible CLI or manifest changes.\n- **Minor versions** are incremented for new features, including modifications to pre-built toolsets or beta features.\n- **Patch versions** are incremented for backward-compatible bug fixes.\n\nFor more details, see our [Full Versioning Policy](https:\u002F\u002Fmcp-toolbox.dev\u002Freference\u002Fversioning\u002F).\n\n---\n\n## Contributing\n\nContributions are welcome. Please, see the [CONTRIBUTING](CONTRIBUTING.md) guide to get started. \n\nFor technical details on setting up a environment for developing on Toolbox itself, see the [DEVELOPER](DEVELOPER.md) guide.\n\nPlease note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Contributor Code of Conduct](CODE_OF_CONDUCT.md) for more information.\n\n---\n\n## Community\n\nJoin our [Discord community](https:\u002F\u002Fdiscord.gg\u002FGQrFB3Ec3W) to connect with our developers!","# MCP Toolbox for Databases 快速上手指南\n\nMCP Toolbox for Databases 是一个开源的 Model Context Protocol (MCP) 服务器，旨在将 AI 助手、IDE 和企业数据库直接连接。它支持开箱即用的通用工具（如查询数据、探索架构），也允许开发者通过配置文件构建自定义的安全数据库工具。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n* **操作系统**: Linux (AMD64), macOS (Intel\u002FApple Silicon), 或 Windows。\n* **运行时依赖**:\n * **Node.js**: 推荐使用 `npx` 快速运行（无需手动安装二进制文件）。\n * 或者：直接下载对应平台的二进制文件或使用 Docker。\n* **数据库访问权限**: 确保您拥有目标数据库的连接信息（主机、端口、用户名、密码等）。\n* **MCP 客户端**: 已安装支持 MCP 协议的客户端（如 Gemini CLI, Claude Code, Cursor, 或其他兼容 IDE）。\n\n## 安装步骤\n\n您可以选择以下任一方式启动 Toolbox 服务器：\n\n### 方式一：使用 npx 快速运行（推荐用于测试）\n\n无需下载二进制文件，直接通过 npm 运行最新版本的服务器。\n\n```bash\nnpx @toolbox-sdk\u002Fserver --prebuilt=postgres\n```\n*注：将 `postgres` 替换为您需要的数据库类型（如 `mysql`, `bigquery` 等）。*\n\n### 方式二：安装二进制文件（生产环境推荐）\n\n根据您的操作系统执行以下命令下载可执行文件：\n\n**Linux (AMD64)**\n```bash\nexport VERSION=1.0.0\ncurl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Flinux\u002Famd64\u002Ftoolbox\nchmod +x toolbox\n```\n\n**macOS (Apple Silicon)**\n```bash\nexport VERSION=1.0.0\ncurl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fdarwin\u002Farm64\u002Ftoolbox\nchmod +x toolbox\n```\n\n**macOS (Intel)**\n```bash\nexport VERSION=1.0.0\ncurl -L -o toolbox https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fdarwin\u002Famd64\u002Ftoolbox\nchmod +x toolbox\n```\n\n**Windows (PowerShell)**\n```powershell\n$VERSION = \"1.0.0\"\ncurl.exe -o toolbox.exe \"https:\u002F\u002Fstorage.googleapis.com\u002Fmcp-toolbox-for-databases\u002Fv$VERSION\u002Fwindows\u002Famd64\u002Ftoolbox.exe\"\n```\n\n### 方式三：使用 Docker\n\n```bash\nexport VERSION=1.0.0\ndocker pull gcr.io\u002Fcloud-devrel-public-resources\u002Fmcp-toolbox:v$VERSION\n```\n\n## 基本使用\n\nMCP Toolbox 提供两种主要使用模式：**开箱即用模式**（预建工具）和 **自定义工具模式**。\n\n### 场景一：连接 IDE 使用预建工具（最快上手）\n\n此模式允许您在 IDE 中直接用自然语言查询数据库、查看表结构。\n\n1. **配置 MCP 客户端**\n 在您的 MCP 客户端配置文件（通常是 `mcp.json` 或 `claude_desktop_config.json`）中添加以下配置：\n\n ```json\n {\n \"mcpServers\": {\n \"toolbox-postgres\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@toolbox-sdk\u002Fserver\",\n \"--prebuilt=postgres\"\n ]\n }\n }\n }\n ```\n\n2. **设置环境变量**\n 在终端中设置数据库连接所需的环境变量（具体变量名参考官方文档，通常包括 `DB_HOST`, `DB_USER`, `DB_PASSWORD` 等）：\n\n ```bash\n export DB_HOST=127.0.0.1\n export DB_PORT=5432\n export DB_NAME=my_database\n export DB_USER=my_user\n export DB_PASSWORD=my_password\n ```\n\n3. **开始使用**\n 重启您的 IDE 或 MCP 客户端。现在您可以直接在对话框中输入：“列出所有表”或“查询用户表中最近注册的用户”，AI 将自动调用数据库工具执行操作。\n\n### 场景二：构建自定义安全工具\n\n如果您需要限制 AI 只能执行特定的 SQL 语句（例如只读查询或特定业务逻辑），请使用 `tools.yaml` 配置文件。\n\n1. **创建配置文件 `tools.yaml`**\n\n ```yaml\n sources:\n - kind: source\n name: my-pg-source\n type: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n\n tools:\n - kind: tool\n name: search-hotels-by-name\n type: postgres-sql\n source: my-pg-source\n description: 根据名称搜索酒店。\n parameters:\n - name: name\n type: string\n description: 酒店名称。\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n ```\n\n2. **启动服务器**\n 使用 `--config` 参数加载您的配置文件：\n\n ```bash\n .\u002Ftoolbox --config tools.yaml\n # 或者使用 npx\n npx @toolbox-sdk\u002Fserver --config tools.yaml\n ```\n\n3. **集成使用**\n 在 MCP 客户端配置中指向该服务器启动命令。此时，AI 代理只能调用您定义的 `search-hotels-by-name` 工具，无法执行任意 SQL，从而保证数据安全。","某电商公司的数据分析师正试图通过 AI 助手快速查询上周的用户订单趋势，以应对突发的运营会议需求。\n\n### 没有 mcp-toolbox 时\n- **流程繁琐低效**：分析师无法直接让 AI 访问数据库，必须手动编写 SQL 语句并在数据库客户端执行，再将结果复制给 AI 分析，来回切换耗时耗力。\n- **安全风险高企**：若直接将数据库账号密码配置给 AI 插件，极易导致敏感数据泄露或缺乏权限控制的误操作（如误删表）。\n- **开发重复造轮子**：团队若想定制“自然语言查销量”功能，需从头搭建 API 网关、编写鉴权逻辑和参数校验代码，耗费数天开发周期。\n- **上下文割裂**：AI 无法理解数据库的实时 Schema 结构，生成的 SQL 常因字段名错误或类型不匹配而执行失败。\n\n### 使用 mcp-toolbox 后\n- **直连对话式分析**：分析师在 IDE 或 CLI 中直接指令 AI“查询上周订单”，mcp-toolbox 作为安全中间层即时连接数据库并返回结果，实现秒级响应。\n- **企业级安全管控**：通过预定义的受限访问策略（Restricted Access），仅开放只读权限和特定表范围，彻底杜绝数据泄露与误删风险。\n- **零代码定制工具**：利用其自定义框架，团队仅需配置文件即可将复杂的“语义搜索”或\"NL2SQL\"逻辑封装为标准工具，几分钟内上线生产环境。\n- **智能感知增强**：mcp-toolbox 自动向 AI 暴露准确的数据库元数据，确保生成的 SQL 语法正确且符合当前表结构，大幅提升执行成功率。\n\nmcp-toolbox 通过标准化的协议桥接，将原本割裂、高危的数据库交互转变为安全、即时且可定制的 AI 原生工作流。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgoogleapis_mcp-toolbox_703a7e4c.png","googleapis","Google APIs","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fgoogleapis_5b6fe389.png","Clients for Google APIs and tools that help produce them.",null,"https:\u002F\u002Fgoogleapis.github.io","https:\u002F\u002Fgithub.com\u002Fgoogleapis",[80,84,88,92,96,100,104],{"name":81,"color":82,"percentage":83},"Go","#00ADD8",96,{"name":85,"color":86,"percentage":87},"JavaScript","#f1e05a",1.4,{"name":89,"color":90,"percentage":91},"HTML","#e34c26",1.1,{"name":93,"color":94,"percentage":95},"SCSS","#c6538c",0.7,{"name":97,"color":98,"percentage":99},"Shell","#89e051",0.4,{"name":101,"color":102,"percentage":103},"CSS","#663399",0.3,{"name":105,"color":106,"percentage":107},"Dockerfile","#384d54",0,14518,1447,"2026-04-13T10:42:07","Apache-2.0","Linux, macOS, Windows","未说明",{"notes":115,"python":116,"dependencies":117},"该工具是基于 Model Context Protocol (MCP) 的数据库服务器，核心由 Go 语言开发。运行方式灵活：1. 可通过 npx 直接运行 (@toolbox-sdk\u002Fserver)；2. 可下载预编译的二进制文件 (支持 Linux\u002FmacOS\u002FWindows 多架构)；3. 可使用 Docker 容器运行。需配置 tools.yaml 文件或环境变量来连接数据库（支持 PostgreSQL, MySQL, BigQuery, Spanner, MongoDB 等多种数据库）。无需 GPU，主要消耗取决于连接的数据库负载而非工具本身。","未说明 (核心服务为 Go 语言编写，提供 Python\u002FJS\u002FGo\u002FJava SDK)",[118,119,120],"npx (Node.js)","Docker (可选)","Go (编译源码时)",[16,52,14,35,15,13],[123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142],"genai","mcp","agent","ai","database","llm","server","agents","bigquery","elasticsearch","firestore","mongodb","mysql","oracle","postgresql","spanner","clickhouse","redis","tidb","cockroachdb","2026-03-27T02:49:30.150509","2026-04-13T23:54:43.472754",[146,151,156],{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},32137,"如何在 ADK Agent 中正确使用 ToolboxClient（异步）与 ToolboxSyncClient（同步）？","使用同步客户端时，直接实例化 ToolboxSyncClient 并在工具加载函数中返回 load_toolset() 的结果。示例代码：\nfrom toolbox_core import ToolboxSyncClient, auth_methods\nauth_token_provider = auth_methods.aget_google_id_token(URL)\ntoolbox = ToolboxSyncClient(URL, client_headers={\"Authorization\": auth_token_provider})\ndef get_tools(): return toolbox.load_toolset()\n\n使用异步客户端时，需实例化 ToolboxClient 并使用 async\u002Fawait 语法加载工具集。示例代码：\nfrom toolbox_core import ToolboxClient, auth_methods\nauth_token_provider = auth_methods.aget_google_id_token(URL)\ntoolbox = ToolboxClient(URL, client_headers={\"Authorization\": auth_token_provider})\nasync def get_tools(): return await toolbox.load_toolset()\n注意：若遇到 Pydantic 验证错误（如 Input should be callable），请确保传递给 Agent 的 tools 参数是实际的工具列表而非客户端对象本身。","https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F955",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},32138,"LLM 调用工具前如何验证或修改参数以避免错误执行？","可以利用编排框架（如 LangChain 或 Google ADK）提供的回调函数在工具执行前拦截并处理参数。例如，在 LangChain 中使用 on_tool_start 回调，或在 ADK 中使用 pre_tool_callback。这样可以在 LLM 提取了错误的参数值时，先进行检查，若参数无效则直接返回建议消息给 LLM 和用户，而无需真正调用后端工具。","https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F708",{"id":157,"question_zh":158,"answer_zh":159,"source_url":160},32139,"如何在 MySQL、BigQuery 等 SQL 工具中将参数动态替换为表名或列名（标识符）？","Toolbox 现已支持模板参数（Template Parameters），允许在语句中直接替换标识符（如表名、列名）。在 tools.yaml 配置中，使用 $1, $2 等占位符即可。例如：statement: SELECT $1 FROM $2 $3;。请注意，模板参数直接拼接进 SQL 语句，存在 SQL 注入风险，因此仅建议在受控环境下使用；对于普通值过滤，仍推荐使用基础参数（通常对应 ? 占位符）以保证性能和安全性。","https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F535",[162,167,172,177,182,187,192,197,202,207,212,217,222,227,232,237,242,247,252,257],{"id":163,"version":164,"summary_zh":165,"released_at":166},239394,"v1.0.0","## [1.0.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcompare\u002Fv0.32.0...v1.0.0) (2026-04-10)\n\n\n> [!IMPORTANT]\n> 这是首个稳定版。请查阅 [UPGRADING.md](UPGRADING.md) 指南，了解从先前的测试版迁移的说明。\n\n\n### ⚠ 重大变更\n\n* **tools\u002Felasticsearch:** 增加向量搜索支持，并移除通过参数传递查询的功能 ([#2891](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2891))\n* **tools\u002Flooker:** 将 looker-git-branch 工具重构为5个独立工具 ([#2976](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2976))\n\n### 功能特性\n\n* **auth:** 支持对 `generic` authService 进行不透明令牌验证 ([#2944](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2944)) ([c924701](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fc924701adede95877594423d78b7ae72fe0b9c82))\n* **cloudsqlpg:** 在成功建立连接后执行 `SELECT 1` 查询 ([#2997](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2997)) ([6ed9700](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F6ed9700e15f08b31e65eb0afa605f4a8ea937e66))\n* **tools\u002Fbigquerysql:** 增加语义搜索支持 ([#2890](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2890)) ([862c396](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F862c396cadfa1d95d12cc121312a81035c22cbad))\n* **tools\u002Felasticsearch-execute-esql:** 新增用于执行任意 ES\u002FQL 查询的工具 ([#3013](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F3013)) ([ae49fb7](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fae49fb737031d783b6734a0ea35488dd0f4c7ccc))\n* **tools\u002Felasticsearch:** 增加向量搜索支持，并移除通过参数传递查询的功能 ([#2891](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2891)) ([d44e879](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fd44e879336f6628790e3f1dca2477cb56fe8f080))\n* **tools\u002Flooker:** 将 looker-git-branch 工具重构为5个独立工具 ([#2976](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2976)) ([b2472d4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fb2472d4926dacc496fc6956185fb281b5e75f56f))\n* **tools\u002Fmysql:** 新增 list-table-stats-tool 工具，用于列出 MySQL 和 Cloud SQL MySQL 数据源中的表统计信息。([#2938](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2938)) ([dc2c2b4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fdc2c2b44e512e34d4d3a0b9c63b59374c37c4c4a))\n\n| **操作系统\u002F架构** | **描述** | **SHA256 哈希值** |\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fmcp","2026-04-10T01:18:02",{"id":168,"version":169,"summary_zh":170,"released_at":171},239395,"v0.32.0","## [0.32.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcompare\u002Fv0.31.0...v0.32.0) (2026-04-08)\n\n\n### ⚠ 重大变更\n\n* 更新仓库名称 ([#2968](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2968))\n\n### 功能\n\n* 将 MCP 工具注解添加到所有剩余工具 ([#2221](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2221)) ([ea09db9](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fea09db90ce3ed78225dc246cedefd30064a88fad))\n* **bigquery:** 为数据代理添加对话式分析工具 ([#2517](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2517)) ([2490a4b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F2490a4b4fb3c9232270f6f4347b8556d2d6e0390))\n* **embeddingModel:** 添加后端 API 选择字段 ([#2592](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2592)) ([912aa9e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F912aa9edd7bc3ce932828003fbd67d1a3b9c2348))\n* **skills:** 在生成的脚本中添加 Claude Code 支持 ([#2966](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2966)) ([a1609e1](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fa1609e10a2eaf4ea68eae36acec3eed355b8a052))\n* **skills:** 添加 Codex 用户代理 ([#2973](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2973)) ([070e939](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F070e9399c02f088d43175ce6bf343378beb7f584))\n* **skills:** 通过 npx 调用工具 ([#2916](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2916)) ([377dc5b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F377dc5b00145a0044eef39314dd6b0ef5966fcd7))\n* **sources\u002Fsinglestore:** 将 ConnectionParams 添加到 SingleStore 配置中 ([#2555](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2555)) ([73e2a8c](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F73e2a8c5cb5ef095a53df9be1d600cc7d508ea19))\n* **tool\u002Fdataplex-lookup-context:** 放宽项目约束并强制执行位置设置 ([#2952](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2952)) ([7ebfdf1](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F7ebfdf1cfc7debac020de51be1aa01c81628879e))\n* **tools\u002Flooker:** 从 MCP 管理 Looker 代理 ([#2830](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2830)) ([649d4ad](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F649d4ad26f0d4d883ae3dbcc0c7f8069adc0d639))\n* **ui:** 更新以使用 `\u002Fmcp` 端点 ([#2829](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2829)) ([c3059c2](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002Fc3059c233502a1e99abb4d87e4b9bfe7c6ea7a4a))\n\n\n### 错误修复\n\n* **bigquery:** 在预构建配置中添加 impersonateServiceAccount ([#2770](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2770)) ([9c3a748](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F9c3a748de43eb588586f22590ff74bd433b24d68))\n* **quickstart:** 增强工具查找功能，并在 Python 示例中更新依赖项 ([#2863](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fissues\u002F2863)) ([4c0845d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fmcp-toolbox\u002Fcommit\u002F4c0845dc9081d79046dea5f28a032d531faff40f))\n* **skills:** 修复技能生成","2026-04-08T22:46:57",{"id":173,"version":174,"summary_zh":175,"released_at":176},239396,"v0.31.0","## [0.31.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.30.0...v0.31.0) (2026-03-26)\n\n\n### ⚠ 重大变更\n\n* 发布升级后的文档站点 ([#2831](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2831))\n* **http:** 对非 2xx 错误响应进行安全清理 ([#2654](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2654))\n* 添加新的 `enable-api` 标志位 ([#2846](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2846))\n* 移除已弃用的内容并更新 `tools-file` 标志位 ([#2806](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2806))\n\n### 功能特性\n\n* 添加新的 `enable-api` 标志位 ([#2846](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2846)) ([7a070da](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F7a070dae4f1833671649ea605f36659675d402a9))\n* **auth:** 为 MCP 添加通用的 `authService` 类型 ([#2619](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2619)) ([f6678f8](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ff6678f8e29aa3346f4f73ce33cec37b4753d6947))\n* **auth:** 添加受保护资源元数据端点 ([#2698](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2698)) ([b53dcf2](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fb53dcf20694599f8b961c501a532bd122630b6f4))\n* **auth:** 支持手动覆盖 PRM ([#2717](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2717)) ([283e4e3](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F283e4e33172571e4b20fa6a3ea0cfc632a565e6a))\n* **dataplex:** 增加对查找上下文工具的支持。([#2744](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2744)) ([facb69d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ffacb69d01fe0c7ff9e2e1c40804dd00762e508a6))\n* 移除已弃用的内容并更新 `tools-file` 标志位 ([#2806](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2806)) ([ab64c95](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fab64c9514a467d92a4547eda5a4ecdd08f86b0c9))\n\n\n### Bug 修复\n\n* **ci:** 从预览部署工作流中移除搜索索引生成 ([#2859](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2859)) ([f8891b8](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ff8891b82fcaaef240e1031cd9f784749d91d4210))\n* **docs:** 在分页中跳过空文件夹，并减少 PR 评论中的噪音 ([#2853](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2853)) ([9ebd93a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9ebd93a8ecb9bae673aa77a859803629fc7a4e1d))\n* **http:** 对非 2xx 错误响应进行安全清理 ([#2654](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2654)) ([5bef954](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5bef954507c8e23b6c9b0eb2551265e4be32b452))\n* **skills:** 修复通过代理技能解析整数参数的问题 ([#2847](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2847)) ([4564efe](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F4564efe75436b4081d9f3d1f7c912bc64c13f850))\n\n\n### 文档\n\n* 发布升级后的文档站点 ([#2831](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2831)) ([5b25ce0](https:\u002F\u002Fgithub.com\u002Fgooglea","2026-03-27T00:00:30",{"id":178,"version":179,"summary_zh":180,"released_at":181},239397,"v0.30.0","## [0.30.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.29.0...v0.30.0) (2026-03-20)\n\n\n### 功能特性\n\n* **cli:** 添加 migrate 子命令 ([#2679](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2679)) ([12171f7](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F12171f7a02bcd34ce647db10abdb79bb2dac7ace))\n* **cli:** 添加 serve 子命令 ([#2550](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2550)) ([1e2c7c7](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1e2c7c7804c67bebf5e2ee9b67c6feb6f05292fd))\n* **skill:** 每个工具集仅包含一个技能 ([#2733](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2733)) ([5b85c65](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5b85c65960dba9bfaf4cadca6d44532a153976e1))\n* **source\u002Foracledb:** 为 MCP 工具和配置添加 Oracle 数据库支持，并更新相关工具和文档 ([#2625](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2625)) ([e350fc7](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe350fc7879182aaf592a70c3509ed061164b3913))\n* **tools\u002Flooker:** 支持 Looker 的 git_branch 工具。([#2718](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2718)) ([70ed8a0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F70ed8a0dcb8e654b748a6e3e1c5ef283c26006da))\n* **tools\u002Fdataplex-search-entries:** 为 search_entries 工具添加 `scope` 支持 ([#2740](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2740)) ([10af468](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F10af4682ccd51070463604124293968944d05017))\n\n\n### 错误修复\n\n* **cloudloggingadmin:** 增加日志注入时间并添加身份验证测试 ([#2772](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2772)) ([50b4457](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F50b4457095ec4ac881b3b12719da24d35141f65d))\n* **oracle:** 在 go-ora DSN 中规范化编码后的代理用户名 ([#2469](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2469)) ([b1333cd](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fb1333cd27117655f8ab09f222721e14bea74b487))\n* **postgres:** 更新 execute-sql 工具以避免使用多语句参数 ([#2707](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2707)) ([58bc772](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F58bc772f882f0d9e00f403e73fbec812dd8a03ac))\n* **skills:** 改进标志验证并静音单元测试输出 ([#2759](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2759)) ([f3da6aa](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ff3da6aa5e23b609a1ac9ecc098bccea02f2388ab))\n* **test:** 解决 Healthcare 集成测试运行不稳定的问题 ([#2742](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2742)) ([9590821](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9590821bc7d86c5cbacd29b21d4f85b427a87db4))\n\n\n### 回滚\n\n* **ci:** 在集成测试中实现条件分片逻辑 ([#2763](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2763)) ([1528d7c](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1528d7c38dfaa30bdecbe59c79ba926fa6d18356))\n\n| **操作系统\u002F架构** ","2026-03-20T00:54:05",{"id":183,"version":184,"summary_zh":185,"released_at":186},239398,"v0.29.0","## [0.29.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.28.0...v0.29.0) (2026-03-13)\n\n\n### ⚠ 重大变更\n\n* **source\u002Falloydb:** 重构预构建工具集 ([#2639](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2639))\n* **source\u002Fspanner:** 重构预构建工具集 ([#2641](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2641))\n* **source\u002Fdataplex:** 重构预构建工具集 ([#2640](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2640))\n* **source\u002Foss-db:** 重构预构建工具集 ([#2638](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2638))\n* **source\u002Fcloudsql:** 重构预构建工具集 ([#2635](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2635))\n* **source\u002Fbigquery:** 重构预构建工具集 ([#2637](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2637))\n* **source\u002Ffirestore:** 重构预构建工具集 ([#2636](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2636))\n* 根据语义规范更新遥测指标 ([#2566](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2566))\n\n### 功能特性\n\n* 在嵌入生成中添加用户代理信息 ([#2572](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2572)) ([287251a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F287251a0cfed4d24617e5d0d957026a94f65d820))\n* **skill:** 为生成的技能附加用户代理元数据 ([#2697](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2697)) ([9598a6a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9598a6a32597b9c9abdb0f20c06d86a01b0d011f))\n* **skills:** 向生成技能命令添加“additional-notes”标志 ([#2696](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2696)) ([73bf962](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F73bf962459b76872f748248bb5e289be232a30b6))\n* **skill:** 更新技能生成逻辑 ([#2646](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2646)) ([c233eee](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fc233eee98cd9621526cb286245f3874f5bd6e7da))\n* **source\u002Falloydb:** 重构预构建工具集 ([#2639](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2639)) ([5f3f063](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5f3f063fc7335e47e35fa1a4f93616abbd7959d5))\n* **source\u002Fbigquery:** 重构预构建工具集 ([#2637](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2637)) ([dc984ba](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fdc984badd79f54ff423713a763648c6a6880a640))\n* **sources\u002Fbigquery:** 支持自定义 OAuth 头部名称 ([#2564](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2564)) ([d3baf77](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fd3baf77d61ab30d97edc93587e6f0365b8523fee))\n* **source\u002Fcloudsql:** 重构预构建工具集 ([#2635](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2635)) ([99613dc](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F99613dcc7a06bd3a2324d20e1ef41404cf6fd9d5))\n* **source\u002Fdataplex:** 重构预构建工具集 ([#2640](https:\u002F\u002Fgithu","2026-03-13T22:55:38",{"id":188,"version":189,"summary_zh":190,"released_at":191},239399,"v0.28.0","## [0.28.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.27.0...v0.28.0) (2026-03-02)\n\n\n### 功能特性\n\n* 为动态重载添加轮询机制 ([#2466](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2466)) ([fcaac9b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ffcaac9bb957226ee3db1baea24330f337ba88ab7))\n* 添加 SDK 文档迁移的基本模板 ([#1961](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1961)) ([87f2eaf](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F87f2eaf79cdecca7b939151e1543eccf2f812a69))\n* **dataproc:** 添加 Dataproc 源以及列出\u002F获取集群和作业的工具 ([#2407](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2407)) ([cc05e57](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fcc05e5745d1c25a6088702b827cd098250164b7e))\n* **sources\u002Fpostgres:** 添加可配置的 pgx 查询执行模式 ([#2477](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2477)) ([57b77bc](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F57b77bca09ce6ee260bd64af9be5fcef593e9acb))\n* **sources\u002Fredis:** 为 Redis 连接添加 TLS 支持 ([#2432](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2432)) ([d6af290](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fd6af2907fd2dca5a6751d7d42090dd7ebb8ccd48))\n* **tools\u002Flooker:** 为 Looker 启用“获取所有 LookML 测试”、“运行 LookML 测试”以及“从表创建视图”等工具 ([#2522](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2522)) ([e01139a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe01139a90268f8587b9823be1157259c1bcbfd66))\n* **tools\u002Flooker:** 提供列出\u002F创建\u002F删除目录的工具 ([#2488](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2488)) ([0036d8c](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F0036d8c35844c3de2079cb5b2479781e8938525b))\n* **ui:** 使工具列表面板可调整大小 ([#2253](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2253)) ([276cf60](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F276cf604a2bb41861639ed6881557e38dd97a614))\n\n\n### 错误修复\n\n* **ci:** 为分支 PR 的单元测试运行添加路径 ([#2540](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2540)) ([04dd2a7](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F04dd2a77603c7babf01da724dfb77808e3f25fe5))\n* 修复 AlloyDB Omni 的 flake 问题 ([#2431](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2431)) ([62b8309](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F62b830987d65c3573214d04e50742476097ee9e9))\n* **docs\u002Fadk:** 解决依赖重复问题 ([#2418](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2418)) ([4d44abb](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F4d44abb4638926ca50b0fa4dcf10a03e7fab657f))\n* **docs\u002Flangchain:** 将 core 版本修复为 0.3.0，并对齐兼容的依赖项 ([#2426](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2426)) ([36edfd3](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F36edfd3d506e839c092d04cbca1799b5ebc38160))\n* 对显式空参数值强制执行必填校验 ([#2519](https:\u002F\u002Fgithub.com\u002Fgoogleapi","2026-03-02T23:36:38",{"id":193,"version":194,"summary_zh":195,"released_at":196},239400,"v0.27.0","## [0.27.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.26.0...v0.27.0) (2026-02-12)\r\n\r\n\r\n### ⚠ 重大变更\r\n\r\n* 更新配置文件 v2 ([#2369](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2369))([293c1d6](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F293c1d6889c39807855ba5e01d4c13ba2a4c50ce))\r\n* 更新\u002F添加符合 OTEL 语义约定的 mcp 端点详细遥测数据 ([#1987](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1987)) ([478a0bd](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F478a0bdb59288c1213f83862f95a698b4c2c0aab))\r\n\r\n### 功能特性\r\n\r\n* **cli\u002Finvoke:** 添加从 CLI 直接调用工具的支持 ([#2353](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2353)) ([6e49ba4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F6e49ba436ef2390c13feaf902b29f5907acffb57))\r\n* **cli\u002Fskills:** 添加从工具集生成代理技能的支持 ([#2392](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2392)) ([80ef346](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F80ef34621453b77bdf6a6016c354f102a17ada04))\r\n* **cloud-logging-admin:** 添加源代码、工具、集成测试和文档 ([#2137](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2137)) ([252fc30](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F252fc3091af10d25d8d7af7e047b5ac87a5dd041))\r\n* **cockroachdb:** 添加 CockroachDB 与 cockroach-go 的集成 ([#2006](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2006)) ([1fdd99a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1fdd99a9b609a5e906acce414226ff44d75d5975))\r\n* **prebuiltconfigs\u002Falloydb-omni:** 实现 Alloydb omni 数据平面工具 ([#2340](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2340)) ([e995349](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe995349ea0756c700d188b8f04e9459121219f0c))\r\n* **server:** 添加工具调用错误分类 ([#2387](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2387)) ([32cb4db](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F32cb4db712d27579c1bf29e61cbd0bed02286c28))\r\n* **tools\u002Flooker:** 支持 `looker-validate-project` 工具 ([#2430](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2430)) ([a15a128](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa15a12873f936b0102aeb9500cc3bcd71bb38c34))\r\n\r\n\r\n\r\n### 错误修复\r\n\r\n* **dataplex:** 在 MCP Toolbox 中捕获 GCP HTTP 错误 ([#2347](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2347)) ([1d7c498](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1d7c4981164c34b4d7bc8edecfd449f57ad11e15))\r\n* **sources\u002Fcockroachdb:** 将 kind 更新为 type ([#2465](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2465)) ([2d341ac](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F2d341acaa61c3c1fe908fceee8afbd90fb646d3a))\r\n* 在 MCP 结果中显示 Dataplex API 错误 ([#2347](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fpull\u002F2347))([1d7c498](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1d7c4981164c34b4d7bc8edecfd449f57ad11e15))\r\n\r\n| **操作系统\u002F架构** ","2026-02-13T02:03:24",{"id":198,"version":199,"summary_zh":200,"released_at":201},239401,"v0.26.0","## [0.26.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.25.0...v0.26.0) (2026-01-22)\n\n\n### ⚠ 破坏性变更\n\n* 验证工具命名（[#2305](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2305)）（[5054212](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5054212fa43017207fe83275d27b9fbab96e8ab5)）\n* **tools\u002Fcloudgda:** 更新 cloudgda 工具的描述和参数名称（[#2288](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2288)）（[6b02591](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F6b025917032394a66840488259db8ff2c3063016)）\n\n### 功能\n\n* 添加新的 `user-agent-metadata` 标志（[#2302](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2302)）（[adc9589](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fadc9589766904d9e3cbe0a6399222f8d4bb9d0cc)）\n* 将剩余标志添加到 MCP 注册表中的 Toolbox 服务器（[#2272](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2272)）（[5e0999e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5e0999ebf5cdd9046e96857738254b2e0561b6d2)）\n* **embeddingModel:** 将嵌入模型添加到 MCP 处理程序中（[#2310](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2310)）（[e4f60e5](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe4f60e56335b755ef55b9553d3f40b31858ec8d9)）\n* **sources\u002Fbigquery:** 使查询返回的最大行数可配置（[#2262](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2262)）（[4abf0c3](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F4abf0c39e717d53b22cc61efb65e09928c598236)）\n* **prebuilt\u002Fcloud-sql:** 为 Cloud SQL 添加创建备份工具（[#2141](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2141)）（[8e0fb03](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F8e0fb0348315a80f63cb47b3c7204869482448f4)）\n* **prebuilt\u002Fcloud-sql:** 为 Cloud SQL 添加恢复备份工具（[#2171](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2171)）（[00c3e6d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F00c3e6d8cba54e2ab6cb271c7e6b378895df53e1)）\n* 支持组合多个预构建配置（[#2295](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2295)）（[e535b37](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe535b372ea81864d644a67135a1b07e4e519b4b4)）\n* 支持 MCP 规范版本 2025-11-25（[#2303](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2303)）（[4d23a3b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F4d23a3bbf2797b1f7fe328aeb5789e778121da23)）\n* **tools:** 为工具配置添加 `valueFromParam` 支持（[#2333](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2333)）（[15101b1](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F15101b1edbe2b85a4a5f9f819c23cf83138f4ee1)）\n\n\n### 错误修复\n\n* **tools\u002Fcloudhealthcare:** 在获取令牌字符串之前添加客户端授权检查（[#2327](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2327)）（[c25a233](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fc25a2330fea2ac382a398842c9e572e4e19bcb08)）\n\n| **操作系统\u002F架构** ","2026-01-23T00:23:07",{"id":203,"version":204,"summary_zh":205,"released_at":206},239402,"v0.25.0","## [0.25.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.24.0...v0.25.0) (2026年1月8日)\n\n\n### 功能特性\n\n* 添加 `embeddingModel` 支持 ([#2121](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2121)) ([9c62f31](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9c62f313ff5edf0a3b5b8a3e996eba078fba4095))\n* 添加 `allowed-hosts` 标志 ([#2254](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2254)) ([17b41f6](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F17b41f64531b8fe417c28ada45d1992ba430dc1b))\n* 为清单添加参数默认值 ([#2264](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2264)) ([9d1feca](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9d1feca10810fa42cb4c94a409252f1bd373ee36))\n* **snowflake:** 添加 Snowflake 源和工具 ([#858](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F858)) ([b706b5b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fb706b5bc685aeda277f277868bae77d38d5fd7b6))\n* **预构建\u002Fcloud-sql-mysql:** 更新 CSQL MySQL 预构建工具以使用 IAM ([#2202](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2202)) ([731a32e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F731a32e5360b4d6862d81fcb27d7127c655679a8))\n* **源\u002Fbigquery:** 使凭据范围可配置 ([#2210](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2210)) ([a450600](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa4506009b93771b77fb05ae97044f914967e67ed))\n* **源\u002Ftrino:** 添加 SSL 验证选项并修复文档示例 ([#2155](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2155)) ([4a4cf1e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F4a4cf1e712b671853678dba99c4dc49dd4fc16a2))\n* **工具\u002Flooker:** 添加通过 `make_look` 和 `make_dashboard` 设置目标文件夹的功能。([#2245](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2245)) ([eb79339](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Feb793398cd1cc4006d9808ccda5dc7aea5e92bd5))\n* **工具\u002Fpostgressql:** 添加列出存储过程的工具 ([#2156](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2156)) ([cf0fc51](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fcf0fc515b57d9b84770076f3c0c5597c4597ef62))\n* **工具\u002Fpostgressql:** 添加对参数 `embeddedBy` 的配置支持 ([#2151](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2151)) ([17b70cc](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F17b70ccaa754d15bcc33a1a3ecb7e652520fa600))\n\n\n### 缺陷修复\n\n* **服务器:** 添加 `embeddingModel` 配置初始化 ([#2281](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2281)) ([a779975](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa7799757c9345f99b6d2717841fbf792d364e1a2))\n* **源\u002Fcloudgda:** 添加 cloudgda 源的导入 ([#2217](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2217)) ([7daa411](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F7daa4111f4ebfb0a35319fd67a8f7b9f0f99efcf))\n* **工具\u002Falloydb-wait-for-operation:** 修复连接消息生成 ([#2228](https:\u002F\u002Fgithub.c","2026-01-08T22:57:05",{"id":208,"version":209,"summary_zh":210,"released_at":211},239403,"v0.24.0","## [0.24.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.23.0...v0.24.0) (2025年12月19日)\n\n\n### 功能特性\n\n* **sources\u002Fcloud-gemini-data-analytics:** 为 Toolbox 添加 Gemini 数据分析（GDA）集成，支持数据库 NL2SQL 转换 ([#2181](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2181)) ([aa270b2](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Faa270b2630da2e3d618db804ca95550445367dbc))\n* **source\u002Fcloudsqlmysql:** 在 Cloud SQL MySQL 源中添加对 IAM 认证的支持 ([#2050](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2050)) ([af3d3c5](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Faf3d3c52044bea17781b89ce4ab71ff0f874ac20))\n* **sources\u002Foracle:** 添加 Oracle OCI 和 Wallet 支持 ([#1945](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1945)) ([8ea39ec](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F8ea39ec32fbbaa97939c626fec8c5d86040ed464))\n* 支持将预构建工具配置与自定义工具配置相结合 ([#2188](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2188)) ([5788605](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F57886058188aa5d2a51d5846a98bc6d8a650edd1))\n* **tools\u002Fmysql-get-query-plan:** 为 MySQL 源新增 `mysql-get-query-plan` 工具 ([#2123](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2123)) ([0641da0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F0641da0353857317113b2169e547ca69603ddfde))\n\n\n### 缺陷修复\n\n* **spanner:** 将列表图验证移至运行时 ([#2154](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2154)) ([914b3ee](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F914b3eefda40a650efe552d245369e007277dab5))\n\n| **操作系统\u002F架构** | **描述** | **SHA256 哈希值** |\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.24.0\u002Flinux\u002Famd64\u002Ftoolbox) | 适用于运行在 **Intel\u002FAMD 64位处理器** 上的 **Linux** 系统。 | 6de0f5c7e3b8e0749dec0ec78199207ce450dbf0cebe41404a6822780b0abd24 |\n| [darwin\u002Farm64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.24.0\u002Fdarwin\u002Farm64\u002Ftoolbox) | 适用于运行在 **Apple Silicon**（M1、M2、M3 等）处理器上的 **macOS** 系统。 | b281d52fae066ae225dbdbc444c2f6e8ce466eb1bca298179cfc1e1a35cb1680 |\n| [darwin\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.24.0\u002Fdarwin\u002Famd64\u002Ftoolbox) | 适用于运行在 **macOS** 系统上，且使用 **Intel\u002FAMD 64位处理器** 的设备。","2025-12-19T02:07:20",{"id":213,"version":214,"summary_zh":215,"released_at":216},239404,"v0.23.0","## [0.23.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.22.0...v0.23.0) (2025-12-11)\r\n\r\n\r\n### ⚠ BREAKING CHANGES\r\n\r\n* **serverless-spark:** add URLs to create batch tool outputs\r\n* **serverless-spark:** add URLs to list_batches output\r\n* **serverless-spark:** add Cloud Console and Logging URLs to get_batch\r\n* **tools\u002Fpostgres:** Add additional filter params for existing postgres tools ([#2033](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2033))\r\n\r\n### Features\r\n\r\n* **tools\u002Fpostgres:** Add list-table-stats-tool to list table statistics. ([#2055](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2055)) ([78b02f0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F78b02f08c3cc3062943bb2f91cf60d5149c8d28d))\r\n* **looker\u002Ftools:** Enhance dashboard creation with dashboard filters ([#2133](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2133)) ([285aa46](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F285aa46b887d9acb2da8766e107bbf1ab75b8812))\r\n* **serverless-spark:** Add Cloud Console and Logging URLs to get_batch ([e29c061](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe29c0616d6b9ecda2badcaf7b69614e511ac031b))\r\n* **serverless-spark:** Add URLs to create batch tool outputs ([c6ccf4b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fc6ccf4bd87026484143a2d0f5527b2edab03b54a))\r\n* **serverless-spark:** Add URLs to list_batches output ([5605eab](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5605eabd696696ade07f52431a28ef65c0fb1f77))\r\n* **sources\u002Fmariadb:** Add MariaDB source and MySQL tools integration ([#1908](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1908)) ([3b40fea](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F3b40fea25edae607e02c1e8fc2b0c957fa2c8e9a))\r\n* **tools\u002Fpostgres:** Add additional filter params for existing postgres tools ([#2033](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2033)) ([489117d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F489117d74711ac9260e7547163ca463eb45eeaa2))\r\n* **tools\u002Fpostgres:** Add list_pg_settings, list_database_stats tools for postgres ([#2030](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2030)) ([32367a4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F32367a472fae9653fed7f126428eba0252978bd5))\r\n* **tools\u002Fpostgres:** Add new postgres-list-roles tool ([#2038](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2038)) ([bea9705](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fbea97054502cfa236aa10e2ebc8ff58eb00ad035))\r\n\r\n\r\n### Bug Fixes\r\n\r\n* List tables tools null fix ([#2107](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2107)) ([2b45266](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F2b452665983154041d4cd0ed7d82532e4af682eb))\r\n* **tools\u002Fmongodb:** Removed sortPayload and sortParams ([#1238](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1238)) ([c5a6daa](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fc5a6daa7683d2f9be654300d977692c368e55e31))\r\n\r\n\r\n### Miscellaneous Chores\r\n* **looker:** Upgrade to latest go sdk ([#2159](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2159)) ([78e015d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F78e015d7dfd9cce7e2b444ed934da17eb355bc86))\r\n\r\n| **OS\u002FArchitecture** | **Description** | **SHA256 Hash** |\r\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\r\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.23.0\u002Flinux\u002Famd64\u002Ftoolbox) | For **Linux** systems running on **Intel\u002FAMD 64-bit processors**. | f4fc49ad6553afa91f872f36f73ce7c7ed910d9d66b4553723d65ba5c85c29aa |\r\n| [darwin\u002Farm64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.23.0\u002Fdarwin\u002Farm64\u002Ftoolbox) | For **macOS** systems running on **Apple Silicon** (M1, M2, M3, etc.) processors. | 53aa6cfb64ff3bf45f66a5bfe8541b43f3d00b1008ab7ffe7275703016392df3 |\r\n| [darwin\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.23.0\u002Fdarwin\u002Famd64\u002Ftoolbox) | For **macOS** systems running on **Intel processors**. | e554a55f156a1b2303f98916b2c12c9dab57ea2f034d09d7860c651dc0f9f3bf |\r\n| [windows\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.23.0\u002Fwindows\u002Famd64\u002Ftoolbox.exe) | For **Windows** systems running on **Intel\u002FAMD 64-bit processors**. | ce8142cadde6420bfd8bf725de745bb388bb5b7f5a88a93827d8fa63e96b873a |","2025-12-11T22:26:39",{"id":218,"version":219,"summary_zh":220,"released_at":221},239405,"v0.22.0","## [0.22.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.21.0...v0.22.0) (2025-12-04)\r\n\r\n\r\n### Features\r\n\r\n* Add allowed-origins flag ([#1984](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1984)) ([862868f](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F862868f28476ea981575ce412faa7d6a03138f31))\r\n* **tools\u002Fpostgres:** Add list-query-stats and get-column-cardinality functions ([#1976](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1976)) ([9f76026](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9f760269253a8cc92a357e995c6993ccc4a0fb7b))\r\n* **tools\u002Fspanner:** Add spanner list graphs to prebuiltconfigs ([#2056](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2056)) ([0e7fbf4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F0e7fbf465c488397aa9d8cab2e55165fff4eb53c))\r\n* **prebuilt\u002Fcloud-sql:** Add clone instance tool for cloud sql ([#1845](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1845)) ([5e43630](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5e43630907aa2d7bc6818142483a33272eab060b))\r\n* **serverless-spark:** Add create_pyspark_batch tool ([1bf0b51](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1bf0b51f033c956790be1577bf5310d0b17e9c12))\r\n* **serverless-spark:** Add create_spark_batch tool ([17a9792](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F17a979207dbc4fe70acd0ebda164d1a8d34c1ed3))\r\n* Support alternate accessToken header name ([#1968](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1968)) ([18017d6](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F18017d6545335a6fc1c472617101c35254d9a597))\r\n* Support for annotations ([#2007](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2007)) ([ac21335](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fac21335f4e88ca52d954d7f8143a551a35661b94))\r\n* **tool\u002Fmssql:** Set default host and port for MSSQL source ([#1943](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1943)) ([7a9cc63](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F7a9cc633768d9ae9a7ff8230002da69d6a36ca86))\r\n* **tools\u002Fcloudsqlpg:** Add CloudSQL PostgreSQL pre-check tool ([#1722](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1722)) ([8752e05](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F8752e05ab6e98812d95673a6f1ff67e9a6ae48d2))\r\n* **tools\u002Fpostgres-list-publication-tables:** Add new postgres-list-publication-tables tool ([#1919](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1919)) ([f4b1f0a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ff4b1f0a68000ca2fc0325f55a1905705417c38a2))\r\n* **tools\u002Fpostgres-list-tablespaces:** Add new postgres-list-tablespaces tool ([#1934](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1934)) ([5ad7c61](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5ad7c6127b3e47504fc4afda0b7f3de1dff78b8b))\r\n* **tools\u002Fspanner-list-graph:** Tool impl + docs + tests ([#1923](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1923)) ([a0f44d3](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa0f44d34ea3f044dd08501be616f70ddfd63ab45))\r\n\r\n\r\n### Bug Fixes\r\n\r\n* Add import for firebirdsql ([#2045](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2045)) ([fb7aae9](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ffb7aae9d35b760d3471d8379642f835a0d84ec41))\r\n* Correct FAQ to mention HTTP tools ([#2036](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2036)) ([7b44237](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F7b44237d4a21bfbf8d3cebe4d32a15affa29584d))\r\n* Format BigQuery numeric output as decimal strings ([#2084](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2084)) ([155bff8](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F155bff80c1da4fae1e169e425fd82e1dc3373041))\r\n* Set default annotations for tools in code if annotation not provided in yaml ([#2049](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2049)) ([565460c](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F565460c4ea8953dbe80070a8e469f957c0f7a70c))\r\n* **tools\u002Falloydb-postgres-list-tables:** Exclude google_ml schema from list_tables ([#2046](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2046)) ([a03984c](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa03984cc15254c928f30085f8fa509ded6a79a0c))\r\n* **tools\u002Falloydbcreateuser:** Remove duplication of project praram ([#2028](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2028)) ([730ac6d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F730ac6d22805fd50b4a675b74c1865f4e7689e7c))\r\n* **tools\u002Fmongodb:** Remove `required` tag from the `canonical` field ([#2099](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F2099)) ([744214e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F744214e04cd12b11d166e6eb7da8ce4714904abc))\r\n\r\n| **OS\u002FArchitecture** | **Description** | **SHA256 Hash** |\r\n| ------------------------------------------------","2025-12-05T00:11:10",{"id":223,"version":224,"summary_zh":225,"released_at":226},239406,"v0.21.0","## [0.21.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.20.0...v0.21.0) (2025-11-19)\r\n\r\n\r\n### ⚠ BREAKING CHANGES\r\n\r\n* **tools\u002Fspanner-list-tables:** Unmarshal `object_details` json string into map to make response have nested json ([#1894](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1894)) ([446d62a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F446d62acd995d5128f52e9db254dd1c7138227c6))\r\n\r\n\r\n### Features\r\n\r\n* **tools\u002Fpostgres:** Add `long_running_transactions`, `list_locks` and `replication_stats` tools ([#1751](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1751)) ([5abad5d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5abad5d56c6cc5ba86adc5253b948bf8230fa830))\r\n\r\n\r\n### Bug Fixes\r\n\r\n* **tools\u002Falloydbgetinstance:** Remove parameter duplication ([#1993](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1993)) ([0e269a1](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F0e269a1d125eed16a51ead27db4398e6e48cb948))\r\n* **tools:** Check for query execution error for pgxpool.Pool ([#1969](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1969)) ([2bff138](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F2bff1384a3570ef46bc03ebebc507923af261987))\r\n\r\n| **OS\u002FArchitecture** | **Description** | **SHA256 Hash** |\r\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\r\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.21.0\u002Flinux\u002Famd64\u002Ftoolbox) | For **Linux** systems running on **Intel\u002FAMD 64-bit processors**. | bb708743df9b2bff4c02db6aac888596d4041943da61529f706a7419597d9541 |\r\n| [darwin\u002Farm64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.21.0\u002Fdarwin\u002Farm64\u002Ftoolbox) | For **macOS** systems running on **Apple Silicon** (M1, M2, M3, etc.) processors. | f4aadb2a47ec1020f7b4174a47762c63c745f3b063ac9ae3c7c6b840b37da99e |\r\n| [darwin\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.21.0\u002Fdarwin\u002Famd64\u002Ftoolbox) | For **macOS** systems running on **Intel processors**. | 536c877da4acced4d40888be353660b2aad5fcefbeca9f473eb5eb959f06dcd4 |\r\n| [windows\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.21.0\u002Fwindows\u002Famd64\u002Ftoolbox.exe) | For **Windows** systems running on **Intel\u002FAMD 64-bit processors**. | 110819461d21ee2d5cfbc1c7cfe4944a5835b7132779dd3eb9b71f34ee621e1f |","2025-11-19T21:38:19",{"id":228,"version":229,"summary_zh":230,"released_at":231},239407,"v0.20.0","## [0.20.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.19.1...v0.20.0) (2025-11-14)\r\n\r\n\r\n### Features\r\n\r\n* Added prompt support for toolbox ([#1798](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1798)) ([cd56ea4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fcd56ea44fbdd149fcb92324e70ee36ac747635db))\r\n* **source\u002Falloydb, source\u002Fcloud-sql-postgres,source\u002Fcloud-sql-mysql,source\u002Fcloud-sql-mssql:** Use project from env for alloydb and cloud sql control plane tools ([#1588](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1588)) ([12bdd95](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F12bdd954597e49d3ec6b247cc104584c5a4d1943))\r\n* **source\u002Fmysql:** Set default host and port for MySQL source ([#1922](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1922)) ([2c228ef](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F2c228ef4f2d4cb8dfc41e845466bfe3566d141a1))\r\n* **source\u002FPostgresql:** Set default host and port for Postgresql source ([#1927](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1927)) ([7e6e88a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F7e6e88a21f2b9b60e0d645cdde33a95892d31a04))\r\n* **tool\u002Flooker-generate-embed-url:** Adding generate embed url tool ([#1877](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1877)) ([ef63860](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fef63860559798fbad54c1051d9f53bce42d66464))\r\n* **tools\u002Fpostgres:** Add `list_triggers`, `database_overview` tools for postgres ([#1912](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1912)) ([a4c9287](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa4c9287aecf848faa98d973a9ce5b13fa309a58e))\r\n* **tools\u002Fpostgres:** Add list_indexes, list_sequences tools for postgres ([#1765](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1765)) ([897c63d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F897c63dcea43226262d2062088c59f2d1068fca7))\r\n\r\n| **OS\u002FArchitecture** | **Description** | **SHA256 Hash** |\r\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\r\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.20.0\u002Flinux\u002Famd64\u002Ftoolbox) | For **Linux** systems running on **Intel\u002FAMD 64-bit processors**. | c6e3c98990d99a2f739af94df32f6d80b5f7ad2f286c39b25d9ccd5f819d61c5 |\r\n| [darwin\u002Farm64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.20.0\u002Fdarwin\u002Farm64\u002Ftoolbox) | For **macOS** systems running on **Apple Silicon** (M1, M2, M3, etc.) processors. | fe3965a9b6a90a6a039f2013dae571632a70cdf0d24b86fb9406fc76d11fc598 |\r\n| [darwin\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.20.0\u002Fdarwin\u002Famd64\u002Ftoolbox) | For **macOS** systems running on **Intel processors**. | 11d7cd47cb6b052cce6256c65d73c239acaaa6368727460b2ace300a89af37b0 |\r\n| [windows\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.20.0\u002Fwindows\u002Famd64\u002Ftoolbox.exe) | For **Windows** systems running on **Intel\u002FAMD 64-bit processors**. | 939a593c88c70633d0074b3de0b08588c8e82e503ab1f1b5a0007749dc9a9716 |","2025-11-14T01:37:10",{"id":233,"version":234,"summary_zh":235,"released_at":236},239408,"v0.19.1","## [0.19.1](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.19.0...v0.19.1) (2025-11-07)\r\n\r\n\r\n### ⚠ BREAKING CHANGES\r\n\r\n* **tools\u002Falloydbainl:** update AlloyDB AI NL statement order ([#1753](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1753))\r\n* **tools\u002Fbigquery-analyze-contribution:** Add allowed dataset support ([#1675](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1675)) ([ef28e39](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fef28e39e90b21287ca8e69b99f4e792c78e9d31f))\r\n* **tools\u002Fbigquery-get-dataset-info:** add allowed dataset support ([#1654](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1654))\r\n\r\n### Features\r\n\r\n* Support `excludeValues` for parameters ([#1818](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1818)) ([a8e98dc](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa8e98dc99d208e8b37a3bc4d1ab4749b5154ed36))\r\n* **elasticsearch:** Add Elasticsearch source and tools ([#1109](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1109)) ([5367285](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5367285e91ddda99ae7261d8ed4b025f975d1453))\r\n* **mindsdb:** Add MindsDB Source and Tools ([#878](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F878)) ([1b2cca9](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1b2cca9faa6f7bacbeb5d25634ce3bf61067de16))\r\n* **cloud-healthcare:** Add support for healthcare source, tool and prebuilt config ([#1853](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1853)) ([1f833fb](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1f833fb1a124e23819ddfec476f2e63ef31dd22f))\r\n* **singlestore:** Add SingleStore Source and Tools ([#1333](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1333)) ([40b9dba](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F40b9dbab088add05a66995abb1c71a9345b8f7e5))\r\n* **source\u002Fbigquery:** Add client cache for user-passed credentials ([#1119](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1119)) ([cf7012a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fcf7012a82bb5c77309da3a26e563a5015786aa69))\r\n* **source\u002Fbigquery:** Add service account impersonation support for bigquery ([#1641](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1641)) ([e09d182](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe09d182f88bf697a169428f477aebc9f1741e35f))\r\n* **tools\u002Fbigquery-analyze-contribution:** Add allowed dataset support ([#1675](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1675)) ([ef28e39](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fef28e39e90b21287ca8e69b99f4e792c78e9d31f))\r\n* **tools\u002Fbigquery-get-dataset-info:** Add allowed dataset support ([#1654](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1654)) ([a2006ad](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa2006ad57718ebad3de5c6850e9c6a5a763808ec))\r\n* **tools\u002Flooker-run-dashboard:** New `run_dashboard` tool ([#1858](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1858)) ([30857c2](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F30857c2294bb14961d3be49e2c368c69ecf844ec))\r\n* **tools\u002Flooker-run-look:** Modify run_look to show query origin ([#1860](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1860)) ([991e539](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F991e539f9c7978fa618ada3179a0b656c33ff501))\r\n* **tools\u002Flooker:** Tools to retrieve the connections, schemas, databases, and column metadata from a looker system. ([#1804](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1804)) ([d7d1b03](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fd7d1b03f3b746ed748d67f67e833457d55c846ab))\r\n* **tools\u002Fmongodb:** Make MongoDB tools' `filterParams` field optional ([#1614](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1614)) ([208ab92](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F208ab92eb377b538a99330a415ecc18790b077b7))\r\n* **tools\u002Fneo4j-execute-cypher:** Add dry_run parameter to validate Cypher queries ([#1769](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1769)) ([f475da6](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ff475da63ce1b65387b503ac497eca47635452723))\r\n* **tools\u002Fpostgres-list-schemas:** Add new postgres-list-schemas tool ([#1741](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1741)) ([1a19cac](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1a19cac7cd89ed70291eb55e190370fe7b2c1aba))\r\n* **tools\u002Fpostgres-list-views:** Add new postgres-list-views tool ([#1709](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1709)) ([e8c7fe0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe8c7fe0994fedcb9be78d461fab3c98cc6bd86b2))\r\n* **tools\u002Fserverless-spark:** Add cancel-batch tool ([#1827](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fpull\u002F1827))([2881683](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F28816832265250de97d84e6ba38bf6c35e040796))\r\n* **tools\u002Fserverless-spark:** Add get_batch tool ([#1783](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fpull\u002F1783))([7ad1072](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F7ad10720b4638324cd77d8aa410cbd1ccf0cc93f))\r\n* **tools\u002Fserverless-spark:** Add serverless-","2025-11-07T20:42:03",{"id":238,"version":239,"summary_zh":240,"released_at":241},239409,"v0.18.0","## [0.18.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.17.0...v0.18.0) (2025-10-23)\r\n\r\n\r\n### Features\r\n\r\n* Support `allowedValues`, `escape`, `minValue` and `maxValue` for parameters ([#1770](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1770)) ([eaf7740](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Feaf77406fd386c12315d67eb685dc69e0415c516))\r\n* **tools\u002Flooker:** Tools to allow the agent to retrieve, create, modify, and delete LookML project files. ([#1673](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1673)) ([089081f](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F089081feb0e32f9eb65d00df5987392d413a4081))\r\n\r\n\r\n### Bug Fixes\r\n\r\n* **sources\u002Fmysql:** Escape mysql user agent ([#1707](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1707)) ([eeb694c](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Feeb694c20facc40a38bfa67073c4cb1f3dd657ff))\r\n* **sources\u002Fmysql:** Escape program_name for MySQL ([#1717](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1717)) ([02f7f8a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F02f7f8af979057efe99fd138cb1b958130355b68))\r\n* **tools\u002Fhttp:** Allow 2xx status code on tool invocation ([#1761](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1761)) ([a06d0d8](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa06d0d8735fbec29bea97457248845a8c6b4aa3c))\r\n* **tools\u002Fhttp:** Omit optional nil query parameters ([#1762](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1762)) ([bd16ba3](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fbd16ba3921e6177065780e5f29870859b8e18e4f))\r\n* **tools\u002Flooker:** Looker file content calls should not use url.QueryEscape ([#1758](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1758)) ([336de1b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F336de1bd04b869d322c0fd1f4667eb652159d791))\r\n\r\n| **OS\u002FArchitecture** | **Description** | **SHA256 Hash** |\r\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\r\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.18.0\u002Flinux\u002Famd64\u002Ftoolbox) | For **Linux** systems running on **Intel\u002FAMD 64-bit processors**. | ae3e5e5bd377816e850cdd3b6fa62510d3d3789b167f5f609f331879a59a6289 |\r\n| [darwin\u002Farm64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.18.0\u002Fdarwin\u002Farm64\u002Ftoolbox) | For **macOS** systems running on **Apple Silicon** (M1, M2, M3, etc.) processors. | f409d3e599b337ec41f74b55b913924422aab6772aeb884bd852ef2d5c425abd |\r\n| [darwin\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.18.0\u002Fdarwin\u002Famd64\u002Ftoolbox) | For **macOS** systems running on **Intel processors**. | a939433c6bd7cd1b55c4d2f07bece8f22409d817f1eb48eaea5d68e67e7a338a |\r\n| [windows\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.18.0\u002Fwindows\u002Famd64\u002Ftoolbox.exe) | For **Windows** systems running on **Intel\u002FAMD 64-bit processors**. | 7a34170dca2b8ce765b4e175ce3ab57043dc566cff5ba505bcc768305df247b8 |","2025-10-23T18:14:54",{"id":243,"version":244,"summary_zh":245,"released_at":246},239410,"v0.17.0","## [0.17.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.16.0...v0.17.0) (2025-10-10)\r\n\r\n\r\n### ⚠ BREAKING CHANGES\r\n\r\n* **tools\u002Fbigquery-get-table-info:** add allowed dataset support ([#1093](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1093))\r\n* **tools\u002Fbigquery-list-dataset-ids:** add allowed datasets support ([#1573](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1573))\r\n\r\n### Features\r\n\r\n* Add configs and workflows for docs versioning ([#1611](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1611)) ([21ac98b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F21ac98bc065e95bde911d66185c67d8380891bf8))\r\n* Add metadata in MCP Manifest for Toolbox auth ([#1395](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1395)) ([0b3dac4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F0b3dac41322f7aaa5a19df571686fa8fd4338ca5))\r\n* Add program name to MySQL connections ([#1617](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1617)) ([c4a22b8](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fc4a22b8d3bd0307325215ebd2f30ba37927cd37e))\r\n* **source\u002Fbigquery:** Add optional write mode config ([#1157](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1157)) ([63adc78](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F63adc78beae949dfe5e300c50e5ceef073e9652c))\r\n* **sources\u002Falloydb,cloudsqlpg,cloudsqlmysql,cloudsqlmssql:** Support PSC connection ([#1686](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1686)) ([9d2bf79](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9d2bf79becfda104ef77f34b8d4b22cbedbc4bf3))\r\n* **sources\u002Fmssql:** Add app name to MSSQL ([#1620](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1620)) ([1536d1f](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1536d1fdabb9d7f73dbdeebeb05a83d9a3b78e1c))\r\n* **sources\u002Foracle:** Add Oracle Source and Tool ([#1456](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1456)) ([3a19a50](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F3a19a50ff211e33429de1d05338d353359a52987))\r\n* **sources\u002Foracle:** Switch Oracle driver from godror to go-ora ([#1685](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1685)) ([8faf376](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F8faf37667e371b4ed88ebb892e8784b67611ba64))\r\n* **tools\u002Fbigquery-list-dataset-ids:** Add allowed datasets support ([#1573](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1573)) ([1a44c67](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1a44c671ec593e764a2d2f67f70a98ceec20a168))\r\n* **tools\u002Fbigquery-get-table-info:** Add allowed dataset support ([#1093](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1093)) ([acb205c](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Facb205ca4761d59ce97b804827230978c8c98ede))\r\n* **tools\u002Fdataform:** Add dataform compile tool ([#1470](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1470)) ([3be9b7b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F3be9b7b3bdf112fe7303706e56e9f39935cde661))\r\n* **tools\u002Flooker:** Add support for pulse, vacuum and analyze audit and performance functions on a Looker instance ([#1581](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1581)) ([5aed4e1](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F5aed4e136d0091731d2ded10ec076ee789e1987c))\r\n* **tools\u002Flooker:** Enable access to the Conversational Analytics API for Looker ([#1596](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1596)) ([2d5a93e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F2d5a93e312990c8a9f3170c7e9c655f97cf11712))\r\n\r\n\r\n### Bug Fixes\r\n\r\n* Added google_ml_integration extension to use alloydb ai-nl support api ([#1445](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1445)) ([dbc477a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fdbc477ab0f832495cf51f73ea16ae363472d6eed))\r\n* Fix broken links ([#1625](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1625)) ([36c6584](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F36c658472ccdeb6cddd8a4452a8b3438aeb0a744))\r\n* Remove duplicated build type in Dockerfile ([#1598](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1598)) ([b43c945](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fb43c94575d86aa65b0528d59f9b41d30b439fee5))\r\n* **source\u002Fbigquery:** Allowed datasets project id issue with client oauth ([#1663](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1663)) ([f4cf486](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ff4cf486fa929299fef076cf71689776e5dec19c1))\r\n* **sources\u002Flooker:** Allow Looker to be configured without setting a Client Id or Secret ([#1496](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1496)) ([67d8221](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F67d8221a2e780df54a81f0f7e8f7e41e4bf1a82e))\r\n* **tools\u002Flooker:** Refactor run-inline-query logic to helper function ([#1497](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1497)) ([62af39d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F62af39d751443eb758586663969b162c868a233f))\r\n* **tools\u002Fmysql-list-tables:** Update sql query to resolve subquery scope error ([#1629](https:\u002F","2025-10-10T20:34:32",{"id":248,"version":249,"summary_zh":250,"released_at":251},239411,"v0.16.0","## [0.16.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.15.0...v0.16.0) (2025-09-25)\r\n\r\n\r\n### ⚠ BREAKING CHANGES\r\n\r\n* **tool\u002Fbigquery-execute-sql:** add allowed datasets support ([#1443](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1443))\r\n* **tool\u002Fbigquery-forecast:** add allowed datasets support ([#1412](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1412))\r\n\r\n### Features\r\n\r\n* **cassandra:** Add Cassandra Source and Tool ([#1012](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1012)) ([6e42053](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F6e420534ee894da4a8d226acb6cdb63d0d5d9ce5))\r\n* **sources\u002Fpostgres:** Add application_name ([#1504](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1504)) ([72a2366](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F72a2366b28870aa6f81c4f890f4770ec5ecffdba))\r\n* **tool\u002Fbigquery-execute-sql:** Add allowed datasets support ([#1443](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1443)) ([9501ebb](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F9501ebbdbcba871b98663185c690308dda1729b5))\r\n* **tool\u002Fbigquery-forecast:** Add allowed datasets support ([#1412](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1412)) ([88bac7e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F88bac7e36f5ebb6ad18773bff30b85ef678431e7))\r\n* **tools\u002Fclickhouse-list-tables:** Add list-tables tool ([#1446](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1446)) ([69a3caf](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F69a3cafabec5a40e2776d71de3587c0d16c722a2))\r\n\r\n\r\n### Bug Fixes\r\n\r\n* **tool\u002Fmongodb-find:** Fix find tool `limit` field ([#1570](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1570)) ([4166bf7](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F4166bf7ab85732f64b877d5f20235057df919049))\r\n* **tools\u002Fmongodb:** Concat filter params only once in mongodb update tools ([#1545](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1545)) ([295f9dc](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F295f9dc41a43f0a4bdbd99e465bf2be01249084e))\r\n\r\n| **OS\u002FArchitecture** | **Description** | **SHA256 Hash** |\r\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\r\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.16.0\u002Flinux\u002Famd64\u002Ftoolbox) | For **Linux** systems running on **Intel\u002FAMD 64-bit processors**. | 751ea87c77c799aba890be22393c1ef47983d39f364b8bb3f24f581252d66ae4 |\r\n| [darwin\u002Farm64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.16.0\u002Fdarwin\u002Farm64\u002Ftoolbox) | For **macOS** systems running on **Apple Silicon** (M1, M2, M3, etc.) processors. | 744be7359f7a7b8903d1575734b316112b88b0192778267e89aa4d3874faf6e1 |\r\n| [darwin\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.16.0\u002Fdarwin\u002Famd64\u002Ftoolbox) | For **macOS** systems running on **Intel processors**. | 5bcae40984b57fe04344fb708141090f4d63361e29a62348830fea4b351e9ac3 |\r\n| [windows\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.16.0\u002Fwindows\u002Famd64\u002Ftoolbox.exe) | For **Windows** systems running on **Intel\u002FAMD 64-bit processors**. | 14acac2e7c9ad8f48878b13b27b7b446c818720ecff442daabb5f6e3bd119f64 |","2025-09-26T01:05:24",{"id":253,"version":254,"summary_zh":255,"released_at":256},239412,"v0.15.0","## [0.15.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.14.0...v0.15.0) (2025-09-18)\r\n\r\n\r\n### ⚠ BREAKING CHANGES\r\n\r\n* **prebuilt:** update prebuilt tool names to use consistent guidance ([#1421](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1421))\r\n* **tools\u002Falloydb-wait-for-operation:** Add `alloydb-admin` source to `alloydb-wait-for-operation` tool ([#1449](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1449))\r\n\r\n### Features\r\n\r\n* Add AlloyDB admin source ([#1369](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1369)) ([33beb71](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F33beb7187d2e0f968fc949a00c780073d1bc7cdd))\r\n* Add Cloud monitoring source and tool ([#1311](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1311)) ([d661f53](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fd661f5343f2ad28fbf0481db16440aec823eece6))\r\n* Add YugabyteDB Source and Tool ([#732](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F732)) ([664711f](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F664711f4b35409bd1c57af92f625b70a0dc9a4e6))\r\n* **prebuilt:** Update default values for prebuilt tools ([#1355](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1355)) ([70e832b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F70e832bd08a98a95b925e590f31c8d3f2d8b6aa0))\r\n* **prebuilt\u002Fcloud-sql:** Add list instances tool for cloudsql ([#1310](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1310)) ([0171228](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F01712284b480774ffa68930affae290ee2e3fcfd))\r\n* **prebuilt\u002Fcloud-sql:** Add cloud sql create database tool. ([#1453](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1453)) ([a1bc044](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fa1bc04477b0f822ffaab039098682f1776b8a472))\r\n* **prebuilt\u002Fcloud-sql:** Add `cloud-sql-get-instances` tool ([#1383](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1383)) ([77919c7](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F77919c7d8e4aac16eeb703c0cc61ca774dc4f94e))\r\n* **prebuilt\u002Fcloud-sql:** Add create user tool for cloud sql ([#1406](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1406)) ([3a6b517](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F3a6b51752f077b225b8c2e2e7308a69a68eec3c0))\r\n* **prebuilt\u002Fcloud-sql:** Add list databases tool for cloud sql ([#1454](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1454)) ([e6a6c61](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fe6a6c615d5480e8930ad173d44d243f5bd99eebc))\r\n* **prebuilt\u002Fcloud-sql:** Package cloud sql tools ([#1455](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1455)) ([bf6266b](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fbf6266ba1131bd1c5829ac112a8c45c8a5919fea))\r\n* **prebuilt\u002Fcloud-sql-mssql:** Add create instance tool for mssql ([#1440](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1440)) ([b176523](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fb17652309d8a02b1f20c6c576b1617b23c8e481f))\r\n* **prebuilt\u002Fcloud-sql-mysql:** Add create instance tool for Cloud SQL MySQL ([#1434](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1434)) ([15b628d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F15b628d2d2feb2ecdd418394b9265a6c77c77f6d))\r\n* **prebuilt\u002Fcloud-sql-mysql:** Add env var support for IP Type ([#1232](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1232)) ([#1347](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1347)) ([0cd3f16](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F0cd3f16f877f426b45e35625ba0af03789459591))\r\n* **prebuilt\u002Fcloudsqlpg:** Add cloud sql pg create instance tool ([#1403](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1403)) ([d302499](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fd30249961b5a2ddc2c3809b481085d1ca034ead0))\r\n* **prebuilt\u002Fmysql:** Add a new tool to show query plan of a given query in MySQL ([#1474](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1474)) ([1a42e05](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F1a42e05675645ac4f1b89edef7a71ac61b637a76))\r\n* **prebuilt\u002Fmysql:** Add `queryParams` field in MySQL prebuilt config ([#1318](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1318)) ([4b32c2a](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F4b32c2a7701ce5ccc56d019055283e73e7046372))\r\n* **prebuilt\u002Fneo4j:** Add prebuiltconfig support for neo4j ([#1352](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1352)) ([f819e26](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Ff819e2644315a589ec283494f244c1b8407cae59))\r\n* **prebuilt\u002Fobservability:** Add cloud sql observability tools ([#1425](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1425)) ([236be89](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F236be89961fe423c1ec992d3d1f699f77a6e5b29))\r\n* **prebuilt\u002Fpostgres:** Add postgres prebuilt tools ([#1473](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1473)) ([edca9dc](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fedca9dc7d772baf1a234485020fa69d76f71bfcc))\r\n* **prebuilt\u002Fsqlite:** Prebuilt tools for the sqlite. ([#1227](https:\u002F\u002Fg","2025-09-19T00:31:11",{"id":258,"version":259,"summary_zh":260,"released_at":261},239413,"v0.14.0","## [0.14.0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcompare\u002Fv0.13.0...v0.14.0) (2025-09-05)\r\n\r\n\r\n### ⚠ BREAKING CHANGES\r\n\r\n* **bigquery:** Move `useClientOAuth` config from tool to source ([#1279](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1279)) ([8d20a48](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F8d20a48f13bcda853d41bdf80a162de12b076d1b))\r\n* **tools\u002Fbigquerysql:** remove `useClientOAuth` from tools config ([#1312](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1312))\r\n\r\n### Features\r\n\r\n* **clickhouse:** Add ClickHouse Source and Tools ([#1088](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1088)) ([75a04a5](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F75a04a55dd2259bed72fe95119a7a51a906c0b21))\r\n* **prebuilt\u002Falloydb-postgres:** Support ipType and IAM users ([#1324](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1324)) ([0b2121e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F0b2121ea72eb81348dcd9c740a62ccd32e71fe37))\r\n* **server\u002Fmcp:** Support toolbox auth in mcp ([#1140](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1140)) ([ca353e0](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fca353e0b66fedc00e9110df57db18632aef49018))\r\n* **source\u002Fmysql:** Support `queryParams` in MySQL source ([#1299](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1299)) ([3ae2526](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F3ae2526e0fe36b57b05a9b54f1d99f3fc68d9657))\r\n* **tools\u002Fbigquery:** Support end-user credential passthrough on multiple BQ tools ([#1314](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1314)) ([88f4b30](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F88f4b3028df3b6a400936cdf8a035bf55021924c))\r\n* **tools\u002Flooker:** Add description for looker-get-models tool ([#1266](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1266)) ([89af3a4](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F89af3a4ca332f029615b2a739d1f6cd50519638d))\r\n* **tools\u002Flooker:** Authenticate via end user credentials ([#1257](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1257)) ([8755e3d](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F8755e3db3476abb35629b3cca9c78db7366757a4))\r\n* **tools\u002Flooker:** Report field suggestions to agent ([#1267](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1267)) ([2cad82e](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F2cad82e5107566dd6c9b75e34e9976af63af0bb5))\r\n\r\n\r\n### Bug Fixes\r\n\r\n* Do not print usage on runtime error ([#1315](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1315)) ([afba7a5](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fafba7a57cdd4fe7c1b0741dbf8f8c78b14a68089))\r\n* Update env var to allow empty string ([#1260](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1260)) ([03aa9fa](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F03aa9fabacda06f860c9f178485126bddb7d5782))\r\n* **tools\u002Ffirestore:** Add document\u002Fcollection path validation ([#1229](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1229)) ([14c2249](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F14c224939a2f9bb349fa00a7d5227877198530c2))\r\n* **tools\u002Flooker-get-dashboards:** Fix Looker client OAuth check ([#1338](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1338)) ([36225aa](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002F36225aa6db7f8426ad87930866530fde4e9bf0cd))\r\n* **tools\u002Foceanbase:** Fix encoded text with mysql driver ([#1283](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1283)) ([d16f89f](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fcommit\u002Fd16f89fbb6e49c03998f114ef7dc2b584b5e4967)), closes [#1161](https:\u002F\u002Fgithub.com\u002Fgoogleapis\u002Fgenai-toolbox\u002Fissues\u002F1161)\r\n\r\n| **OS\u002FArchitecture** | **Description** | **SHA256 Hash** |\r\n| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- |\r\n| [linux\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.14.0\u002Flinux\u002Famd64\u002Ftoolbox) | For **Linux** systems running on **Intel\u002FAMD 64-bit processors**. | 6145c23708e264fab75f0acd7b982d2d624b4987fb00b27f25fae6a74c0d36e4 |\r\n| [darwin\u002Farm64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.14.0\u002Fdarwin\u002Farm64\u002Ftoolbox) | For **macOS** systems running on **Apple Silicon** (M1, M2, M3, etc.) processors. | e389a9527bc97d63b7edaed22ffd1ae3bf796e81d1295ddbbd0373ea1b80ded8 |\r\n| [darwin\u002Famd64](https:\u002F\u002Fstorage.googleapis.com\u002Fgenai-toolbox\u002Fv0.14.0\u002Fdarwin\u002Famd64\u002Ftoolbox) | For **macOS** systems running on **Intel processors**. ","2025-09-05T16:05:11"]