[{"_1":2,"_327":-5,"_328":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_269":270},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",7058884,"membership","referenceId","01971406-43e3-74e8-b880-2f000258007a","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_82":-5,"_83":40,"_29":84,"_186":187,"_268":140},"availableLocales",[28,40,47,54,61,68,75],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Open-Source-MCP-Server, spezialisiert auf einfache, schnelle und sichere Tools für Datenbanken.","name","MCP Toolbox für Datenbanken","readme","![Logo](./logo.png)\n\n# MCP Toolbox für Datenbanken\n\n[![Zwietracht](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\\&logo=discord\\&logoColor=white)](https://discord.gg/Dmm69peqjh) [![Gehe zum Zeugnis](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox)\n\n> \\[!NOTE] MCP Toolbox für Datenbanken befindet sich derzeit in der Betaphase und kann bis zur ersten stabilen Version (v1.0) schwerwiegende Änderungen aufweisen.\n\nMCP Toolbox for Databases ist ein Open-Source-MCP-Server für Datenbanken. Er ermöglicht Ihnen die einfachere, schnellere und sicherere Entwicklung von Tools, indem er komplexe Aufgaben wie Verbindungspooling, Authentifizierung und mehr übernimmt.\n\nDiese README-Datei bietet einen kurzen Überblick. Ausführliche Informationen finden Sie in der [vollständigen Dokumentation](https://googleapis.github.io/genai-toolbox/) .\n\n> \\[!NOTE] Diese Lösung hieß ursprünglich „Gen AI Toolbox for Databases“, da ihre ursprüngliche Entwicklung vor MCP erfolgte. Sie wurde jedoch umbenannt, um sie an die kürzlich hinzugefügte MCP-Kompatibilität anzupassen.\n\n## Inhaltsverzeichnis\n\n* [Warum Toolbox?](#why-toolbox)\n* [Allgemeine Architektur](#general-architecture)\n* [Erste Schritte](#getting-started)\n\n * [Installieren des Servers](#installing-the-server)\n * [Ausführen des Servers](#running-the-server)\n * [Integrieren Ihrer Anwendung](#integrating-your-application)\n* [Konfiguration](#configuration)\n\n * [Quellen](#sources)\n * [Werkzeuge](#tools)\n * [Werkzeugsätze](#toolsets)\n* [Versionierung](#versioning)\n* [Beitragen](#contributing)\n\n## Warum Toolbox?\n\nToolbox unterstützt Sie bei der Entwicklung von Gen-AI-Tools, mit denen Ihre Agenten auf Daten in Ihrer Datenbank zugreifen können. Toolbox bietet:\n\n* **Vereinfachte Entwicklung** : Integrieren Sie Tools in weniger als 10 Codezeilen in Ihren Agenten, verwenden Sie Tools zwischen mehreren Agenten oder Frameworks wieder und stellen Sie neue Versionen von Tools einfacher bereit.\n* **Bessere Leistung** : Best Practices wie Verbindungspooling, Authentifizierung und mehr.\n* **Verbesserte Sicherheit** : Integrierte Authentifizierung für sichereren Zugriff auf Ihre Daten\n* **End-to-End-Beobachtbarkeit** : Sofort einsatzbereite Metriken und Ablaufverfolgung mit integrierter Unterstützung für OpenTelemetry.\n\n## Allgemeine Architektur\n\nToolbox sitzt zwischen dem Orchestrierungsframework Ihrer Anwendung und Ihrer Datenbank und bietet eine Steuerungsebene zum Ändern, Verteilen und Aufrufen von Tools. Es vereinfacht die Verwaltung Ihrer Tools, indem es Ihnen einen zentralen Ort zum Speichern und Aktualisieren von Tools bietet. So können Sie Tools zwischen Agenten und Anwendungen teilen und aktualisieren, ohne Ihre Anwendung neu bereitstellen zu müssen.\n\n![Architektur](./docs/en/getting-started/introduction/architecture.png)\n\n## Erste Schritte\n\n### Installieren des Servers\n\nDie neueste Version finden Sie auf der [Release-Seite](https://github.com/googleapis/genai-toolbox/releases) . Befolgen Sie die folgenden Anweisungen für Ihr Betriebssystem und Ihre CPU-Architektur.\n\nSo installieren Sie Toolbox als Binärdatei:\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ncurl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox\nchmod +x toolbox\n```\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\nUm die Installation aus der Quelle durchzuführen, stellen Sie sicher, dass Sie die neueste Version von [Go installiert](https://go.dev/doc/install) haben, und führen Sie dann den folgenden Befehl aus:\n\n```sh\ngo install github.com/googleapis/genai-toolbox@v0.5.0\n```\n\n### Ausführen des Servers\n\n[Konfigurieren Sie](#configuration) eine `tools.yaml` , um Ihre Tools zu definieren, und führen Sie dann `toolbox` aus, um den Server zu starten:\n\n```sh\n./toolbox --tools-file \"tools.yaml\"\n```\n\nEine vollständige Liste der Flags finden Sie in `toolbox help` . Um den Server zu stoppen, senden Sie ein Beendigungssignal (auf den meisten Plattformen `ctrl+c` ).\n\nAusführlichere Dokumentationen zur Bereitstellung in verschiedenen Umgebungen finden Sie in den Ressourcen im [Abschnitt „Anleitungen“](https://googleapis.github.io/genai-toolbox/how-to/) .\n\n### Integrieren Ihrer Anwendung\n\nSobald Ihr Server betriebsbereit ist, können Sie die Tools in Ihre Anwendung laden. Nachfolgend finden Sie eine Liste der Client-SDKs für die Verwendung verschiedener Frameworks:\n\n1. Installieren Sie [das Toolbox Core SDK](https://pypi.org/project/toolbox-core/) :\n\n ```bash\n pip install toolbox-core\n ```\n\n2. Werkzeuge laden:\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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\nAusführlichere Anweisungen zur Verwendung des Toolbox Core SDK finden Sie in der [README-Datei des Projekts](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md) .\n\n1. Installieren Sie [das Toolbox LangChain SDK](https://pypi.org/project/toolbox-langchain/) :\n\n ```bash\n pip install toolbox-langchain\n ```\n\n2. Werkzeuge laden:\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nAusführlichere Anweisungen zur Verwendung des Toolbox LangChain SDK finden Sie in der [README-Datei des Projekts](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md) .\n\n1. Installieren Sie [das Toolbox Llamaindex SDK](https://pypi.org/project/toolbox-llamaindex/) :\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n2. Werkzeuge laden:\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nAusführlichere Anweisungen zur Verwendung des Toolbox Llamaindex SDK finden Sie in der [README-Datei des Projekts](https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md) .\n\n## Konfiguration\n\nDie primäre Methode zum Konfigurieren von Toolbox ist die Datei `tools.yaml` . Wenn Sie mehrere Dateien haben, können Sie Toolbox mit dem Flag `--tools-file tools.yaml` mitteilen, welche geladen werden soll.\n\nAusführlichere Referenzdokumentation zu allen Ressourcentypen finden Sie in den [Ressourcen](https://googleapis.github.io/genai-toolbox/resources/) .\n\n### Quellen\n\nDer Abschnitt `sources` Ihrer `tools.yaml` definiert, auf welche Datenquellen Ihre Toolbox Zugriff haben soll. Die meisten Tools verfügen über mindestens eine Quelle zur Ausführung.\n\n```yaml\nsources:\n my-pg-source:\n kind: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n```\n\nWeitere Einzelheiten zum Konfigurieren unterschiedlicher Quellentypen finden Sie unter [Quellen](https://googleapis.github.io/genai-toolbox/resources/sources) .\n\n### Werkzeuge\n\nDer Abschnitt `tools` einer `tools.yaml` definiert die Aktionen, die ein Agent ausführen kann: um welche Art von Tool es sich handelt, welche Quelle(n) es betrifft, welche Parameter es verwendet usw.\n\n```yaml\ntools:\n search-hotels-by-name:\n kind: postgres-sql\n source: my-pg-source\n description: Search for hotels based on name.\n parameters:\n - name: name\n type: string\n description: The name of the hotel.\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\nWeitere Einzelheiten zum Konfigurieren unterschiedlicher Werkzeugtypen finden Sie unter „ [Werkzeuge“](https://googleapis.github.io/genai-toolbox/resources/tools) .\n\n### Werkzeugsätze\n\nIm Abschnitt `toolsets` “ Ihrer `tools.yaml` können Sie Toolgruppen definieren, die gemeinsam geladen werden sollen. Dies kann nützlich sein, um verschiedene Gruppen basierend auf Agent oder Anwendung zu definieren.\n\n```yaml\ntoolsets:\n my_first_toolset:\n - my_first_tool\n - my_second_tool\n my_second_toolset:\n - my_second_tool\n - my_third_tool\n```\n\nSie können Toolsets nach Namen laden:\n\n```python\n# This will load all tools\nall_tools = client.load_toolset()\n\n# This will only load the tools listed in 'my_second_toolset'\nmy_second_toolset = client.load_toolset(\"my_second_toolset\")\n```\n\n## Versionierung\n\nDieses Projekt verwendet [semantische Versionierung](https://semver.org/) , einschließlich einer `MAJOR.MINOR.PATCH` -Versionsnummer, die mit Folgendem erhöht wird:\n\n* HAUPTversion, wenn wir inkompatible API-Änderungen vornehmen\n* MINOR-Version, wenn wir Funktionen auf abwärtskompatible Weise hinzufügen\n* PATCH-Version, wenn wir abwärtskompatible Fehlerbehebungen vornehmen\n\nDie öffentliche API, auf die dies zutrifft, ist die mit Toolbox verknüpfte CLI, die Interaktionen mit offiziellen SDKs und die Definitionen in der Datei `tools.yaml` .\n\n## Beitragen\n\nBeiträge sind willkommen. Bitte lesen Sie den [Abschnitt „Beitrag leisten“](CONTRIBUTING.md) , um loszulegen.\n\nBitte beachten Sie, dass für dieses Projekt ein Verhaltenskodex für Mitwirkende gilt. Mit der Teilnahme an diesem Projekt erklären Sie sich mit dessen Bedingungen einverstanden. Weitere Informationen finden Sie [im Verhaltenskodex für Mitwirkende](CODE_OF_CONDUCT.md) .","German","tag","de-DE",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"Open source MCP server specializing in easy, fast, and secure tools for Databases.","MCP Toolbox for Databases","![logo](./logo.png)\n\n# MCP Toolbox for Databases\n\n[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/Dmm69peqjh)\n[![Go Report Card](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox) \n\n> [!NOTE] \n> MCP Toolbox for Databases is currently in beta, and may see breaking \n> changes until the first stable release (v1.0).\n\nMCP Toolbox for Databases is an open source MCP server for databases. It enables\nyou to develop tools easier, faster, and more securely by handling the complexities\nsuch as connection pooling, authentication, and more.\n\nThis README provides a brief overview. For comprehensive details, see the [full\ndocumentation](https://googleapis.github.io/genai-toolbox/).\n\n\n> [!NOTE] \n> This solution was originally named “Gen AI Toolbox for Databases” as\n> its initial development predated MCP, but was renamed to align with recently\n> added MCP compatibility. \n\n\n## Table of Contents\n\n\n\n- [Why Toolbox?](#why-toolbox)\n- [General Architecture](#general-architecture)\n- [Getting Started](#getting-started)\n - [Installing the server](#installing-the-server)\n - [Running the server](#running-the-server)\n - [Integrating your application](#integrating-your-application)\n- [Configuration](#configuration)\n - [Sources](#sources)\n - [Tools](#tools)\n - [Toolsets](#toolsets)\n- [Versioning](#versioning)\n- [Contributing](#contributing)\n\n\n\n\n## Why Toolbox?\n\nToolbox helps you build Gen AI tools that let your agents access data in your\ndatabase. Toolbox provides:\n- **Simplified development**: Integrate tools to your agent in less than 10\n lines of code, reuse tools between multiple agents or frameworks, and deploy\n new versions of tools more easily.\n- **Better performance**: Best practices such as connection pooling,\n authentication, and more.\n- **Enhanced security**: Integrated auth for more secure access to your data\n- **End-to-end observability**: Out of the box metrics and tracing with built-in\n support for OpenTelemetry.\n\n\n## General Architecture\n\nToolbox sits between your application's orchestration framework and your\ndatabase, providing a control plane that is used to modify, distribute, or\ninvoke tools. It simplifies the management of your tools by providing you with a\ncentralized location to store and update tools, allowing you to share tools\nbetween agents and applications and update those tools without necessarily\nredeploying your application.\n\n![architecture](./docs/en/getting-started/introduction/architecture.png)\n\n## Getting Started\n\n### Installing the server\nFor the latest version, check the [releases page][releases] and use the\nfollowing instructions for your OS and CPU architecture.\n\n[releases]: https://github.com/googleapis/genai-toolbox/releases\n\n

Binary

\n\nTo install Toolbox as a binary:\n\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ncurl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox\nchmod +x toolbox\n```\n\n

\n\n

Container image

\nYou can also install Toolbox as a container:\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\n

\n\n

Compile from source

\n\nTo install from source, ensure you have the latest version of\n[Go installed](https://go.dev/doc/install), and then run the following command:\n\n```sh\ngo install github.com/googleapis/genai-toolbox@v0.5.0\n```\n\n\n

\n\n### Running the server\n\n[Configure](#configuration) a `tools.yaml` to define your tools, and then\nexecute `toolbox` to start the server:\n\n```sh\n./toolbox --tools-file \"tools.yaml\"\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 [How-to\nsection](https://googleapis.github.io/genai-toolbox/how-to/)\n\n### Integrating your application\n\nOnce your server is up and running, you can load the tools into your\napplication. See below the list of Client SDKs for using various frameworks:\n\n

Core

\n\n1. Install [Toolbox Core SDK][toolbox-core]:\n ```bash\n pip install toolbox-core\n ```\n1. Load tools:\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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://pypi.org/project/toolbox-core/\n[toolbox-core-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md\n\n

LangChain / LangGraph

\n\n1. Install [Toolbox LangChain SDK][toolbox-langchain]:\n ```bash\n pip install toolbox-langchain\n ```\n1. Load tools:\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nFor more detailed instructions on using the Toolbox LangChain SDK, see the\n[project's README][toolbox-langchain-readme].\n\n[toolbox-langchain]: https://pypi.org/project/toolbox-langchain/\n[toolbox-langchain-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md\n\n

\n\n

LlamaIndex

\n\n1. Install [Toolbox Llamaindex SDK][toolbox-llamaindex]:\n ```bash\n pip install toolbox-llamaindex\n ```\n1. Load tools:\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nFor more detailed instructions on using the Toolbox Llamaindex SDK, see the\n[project's README][toolbox-llamaindex-readme].\n\n[toolbox-llamaindex]: https://pypi.org/project/toolbox-llamaindex/\n[toolbox-llamaindex-readme]: https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md\n\n

\n\n## Configuration\n\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 `--tools-file\ntools.yaml` flag.\n\nYou can find more detailed reference documentation to all resource types in the\n[Resources](https://googleapis.github.io/genai-toolbox/resources/).\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\nsources:\n my-pg-source:\n kind: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n```\n\nFor more details on configuring different types of sources, see the\n[Sources](https://googleapis.github.io/genai-toolbox/resources/sources).\n\n### Tools\n\nThe `tools` section of a `tools.yaml` define the actions an agent can take: what\nkind of tool it is, which source(s) it affects, what parameters it uses, etc.\n\n```yaml\ntools:\n search-hotels-by-name:\n kind: postgres-sql\n source: my-pg-source\n description: Search for hotels based on name.\n parameters:\n - name: name\n type: string\n description: The name of the hotel.\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\nFor more details on configuring different types of tools, see the\n[Tools](https://googleapis.github.io/genai-toolbox/resources/tools).\n\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\ntoolsets:\n my_first_toolset:\n - my_first_tool\n - my_second_tool\n my_second_toolset:\n - my_second_tool\n - my_third_tool\n```\n\nYou can load toolsets by name:\n\n```python\n# This will load all tools\nall_tools = client.load_toolset()\n\n# This will only load the tools listed in 'my_second_toolset'\nmy_second_toolset = client.load_toolset(\"my_second_toolset\")\n```\n\n## Versioning\n\nThis project uses [semantic versioning](https://semver.org/), including a\n`MAJOR.MINOR.PATCH` version number that increments with:\n\n- MAJOR version when we make incompatible API changes\n- MINOR version when we add functionality in a backward compatible manner\n- PATCH version when we make backward compatible bug fixes\n\nThe public API that this applies to is the CLI associated with Toolbox, the\ninteractions with official SDKs, and the definitions in the `tools.yaml` file. \n\n## Contributing\n\nContributions are welcome. Please, see the [CONTRIBUTING](CONTRIBUTING.md)\nto get started.\n\nPlease note that this project is released with a Contributor Code of Conduct.\nBy participating in this project you agree to abide by its terms. See\n[Contributor Code of Conduct](CODE_OF_CONDUCT.md) for more information.\n","English","en-US",{"_29":48,"_33":52,"_38":53},{"_31":49,"_33":50,"_35":51},"Servidor MCP de código abierto especializado en herramientas fáciles, rápidas y seguras para bases de datos.","Caja de herramientas MCP para bases de datos","![logo](./logo.png)\n\n# Caja de herramientas MCP para bases de datos\n\n[![Discordia](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\\&logo=discord\\&logoColor=white)](https://discord.gg/Dmm69peqjh) [![Tarjeta de calificaciones Go](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox)\n\n> \\[!NOTA] MCP Toolbox for Databases se encuentra actualmente en versión beta y puede sufrir cambios importantes hasta el primer lanzamiento estable (v1.0).\n\nMCP Toolbox for Databases es un servidor MCP de código abierto para bases de datos. Permite desarrollar herramientas de forma más sencilla, rápida y segura, gestionando complejidades como la agrupación de conexiones, la autenticación y más.\n\nEste archivo README ofrece una breve descripción general. Para obtener más información, consulte la [documentación completa](https://googleapis.github.io/genai-toolbox/) .\n\n> \\[!NOTA] Esta solución originalmente se llamó “Gen AI Toolbox for Databases” ya que su desarrollo inicial fue anterior a MCP, pero se le cambió el nombre para alinearse con la compatibilidad con MCP agregada recientemente.\n\n## Tabla de contenido\n\n* [¿Por qué Toolbox?](#why-toolbox)\n* [Arquitectura general](#general-architecture)\n* [Empezando](#getting-started)\n\n * [Instalación del servidor](#installing-the-server)\n * [Ejecutando el servidor](#running-the-server)\n * [Integrando su aplicación](#integrating-your-application)\n* [Configuración](#configuration)\n\n * [Fuentes](#sources)\n * [Herramientas](#tools)\n * [Conjuntos de herramientas](#toolsets)\n* [Control de versiones](#versioning)\n* [Contribuyendo](#contributing)\n\n## ¿Por qué Toolbox?\n\nToolbox te ayuda a crear herramientas de inteligencia artificial que permiten a tus agentes acceder a los datos de tu base de datos. Toolbox ofrece:\n\n* **Desarrollo simplificado** : integre herramientas a su agente en menos de 10 líneas de código, reutilice herramientas entre múltiples agentes o marcos e implemente nuevas versiones de herramientas más fácilmente.\n* **Mejor rendimiento** : mejores prácticas como agrupación de conexiones, autenticación y más.\n* **Seguridad mejorada** : autenticación integrada para un acceso más seguro a sus datos\n* **Observabilidad de extremo a extremo** : métricas y seguimiento listos para usar con soporte integrado para OpenTelemetry.\n\n## Arquitectura general\n\nToolbox se ubica entre el marco de orquestación de su aplicación y su base de datos, proporcionando un plano de control para modificar, distribuir o invocar herramientas. Simplifica la gestión de sus herramientas al proporcionar una ubicación centralizada para almacenarlas y actualizarlas, lo que le permite compartirlas entre agentes y aplicaciones y actualizarlas sin tener que volver a implementar la aplicación.\n\n![arquitectura](./docs/en/getting-started/introduction/architecture.png)\n\n## Empezando\n\n### Instalación del servidor\n\nPara obtener la última versión, consulte la [página de lanzamientos](https://github.com/googleapis/genai-toolbox/releases) y utilice las siguientes instrucciones para su sistema operativo y arquitectura de CPU.\n\nPara instalar Toolbox como binario:\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ncurl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox\nchmod +x toolbox\n```\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\nPara instalar desde la fuente, asegúrese de tener [instalada la última versión de Go](https://go.dev/doc/install) y luego ejecute el siguiente comando:\n\n```sh\ngo install github.com/googleapis/genai-toolbox@v0.5.0\n```\n\n### Ejecutando el servidor\n\n[Configure](#configuration) un `tools.yaml` para definir sus herramientas y luego ejecute `toolbox` para iniciar el servidor:\n\n```sh\n./toolbox --tools-file \"tools.yaml\"\n```\n\nPuedes usar `toolbox help` para obtener una lista completa de indicadores. Para detener el servidor, envía una señal de terminación ( `ctrl+c` en la mayoría de las plataformas).\n\nPara obtener documentación más detallada sobre la implementación en diferentes entornos, consulte los recursos en la [sección Cómo hacerlo.](https://googleapis.github.io/genai-toolbox/how-to/)\n\n### Integrando su aplicación\n\nUna vez que su servidor esté en funcionamiento, puede cargar las herramientas en su aplicación. Consulte a continuación la lista de SDK de cliente para usar varios frameworks:\n\n1. Instalar [el SDK de Toolbox Core](https://pypi.org/project/toolbox-core/) :\n\n ```bash\n pip install toolbox-core\n ```\n\n2. Cargar herramientas:\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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\nPara obtener instrucciones más detalladas sobre el uso del SDK de Toolbox Core, consulte el [archivo README del proyecto](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md) .\n\n1. Instalar [el SDK de Toolbox LangChain](https://pypi.org/project/toolbox-langchain/) :\n\n ```bash\n pip install toolbox-langchain\n ```\n\n2. Cargar herramientas:\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nPara obtener instrucciones más detalladas sobre el uso del SDK Toolbox LangChain, consulte el [archivo README del proyecto](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md) .\n\n1. Instalar [el SDK de Toolbox Llamaindex](https://pypi.org/project/toolbox-llamaindex/) :\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n2. Cargar herramientas:\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nPara obtener instrucciones más detalladas sobre el uso del SDK de Toolbox Llamaindex, consulte el [archivo README del proyecto](https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md) .\n\n## Configuración\n\nLa forma principal de configurar Toolbox es mediante el archivo `tools.yaml` . Si tiene varios archivos, puede indicarle a Toolbox cuál cargar con el indicador `--tools-file tools.yaml` .\n\nPuede encontrar documentación de referencia más detallada sobre todos los tipos de recursos en [Recursos](https://googleapis.github.io/genai-toolbox/resources/) .\n\n### Fuentes\n\nLa sección `sources` de tu `tools.yaml` define a qué fuentes de datos debe acceder tu Toolbox. La mayoría de las herramientas tendrán al menos una fuente para ejecutarse.\n\n```yaml\nsources:\n my-pg-source:\n kind: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n```\n\nPara obtener más detalles sobre la configuración de diferentes tipos de fuentes, consulte [Fuentes](https://googleapis.github.io/genai-toolbox/resources/sources) .\n\n### Herramientas\n\nLa sección `tools` de un `tools.yaml` define las acciones que puede realizar un agente: qué tipo de herramienta es, a qué fuente(s) afecta, qué parámetros utiliza, etc.\n\n```yaml\ntools:\n search-hotels-by-name:\n kind: postgres-sql\n source: my-pg-source\n description: Search for hotels based on name.\n parameters:\n - name: name\n type: string\n description: The name of the hotel.\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\nPara obtener más detalles sobre la configuración de diferentes tipos de herramientas, consulte [Herramientas](https://googleapis.github.io/genai-toolbox/resources/tools) .\n\n### Conjuntos de herramientas\n\nLa sección de conjuntos de `toolsets` de `tools.yaml` permite definir grupos de herramientas que se pueden cargar juntas. Esto puede ser útil para definir diferentes grupos según el agente o la aplicación.\n\n```yaml\ntoolsets:\n my_first_toolset:\n - my_first_tool\n - my_second_tool\n my_second_toolset:\n - my_second_tool\n - my_third_tool\n```\n\nPuede cargar conjuntos de herramientas por nombre:\n\n```python\n# This will load all tools\nall_tools = client.load_toolset()\n\n# This will only load the tools listed in 'my_second_toolset'\nmy_second_toolset = client.load_toolset(\"my_second_toolset\")\n```\n\n## Control de versiones\n\nEste proyecto utiliza [control de versiones semántico](https://semver.org/) , incluido un número de versión `MAJOR.MINOR.PATCH` que incrementa con:\n\n* Versión PRINCIPAL cuando realizamos cambios de API incompatibles\n* Versión MENOR cuando agregamos funcionalidad de manera compatible con versiones anteriores\n* Versión PATCH cuando hagamos correcciones de errores compatibles con versiones anteriores\n\nLa API pública a la que se aplica esto es la CLI asociada con Toolbox, las interacciones con los SDK oficiales y las definiciones en el archivo `tools.yaml` .\n\n## Contribuyendo\n\nSe agradecen las contribuciones. Para empezar, consulta la [sección \"CONTRIBUYENDO\"](CONTRIBUTING.md) .\n\nTenga en cuenta que este proyecto se publica con un Código de Conducta del Colaborador. Al participar en este proyecto, acepta cumplir con sus términos. Consulte [el Código de Conducta del Colaborador](CODE_OF_CONDUCT.md) para obtener más información.","Spanish","es-ES",{"_29":55,"_33":59,"_38":60},{"_31":56,"_33":57,"_35":58},"データベース用の簡単、高速、かつ安全なツールに特化したオープンソースの MCP サーバー。","データベース用MCPツールボックス","![ロゴ](./logo.png)\n\n# データベース用MCPツールボックス\n\n[![不和](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\\&logo=discord\\&logoColor=white)](https://discord.gg/Dmm69peqjh) [![囲碁レポートカード](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox)\n\n> \\[!NOTE] MCP Toolbox for Databases は現在ベータ版であり、最初の安定リリース (v1.0) まで互換性に影響する変更が加えられる可能性があります。\n\nMCP Toolbox for Databasesは、データベース用のオープンソースMCPサーバーです。接続プールや認証といった複雑な処理を自動化することで、ツールの開発をより簡単、迅速、そして安全に行うことができます。\n\nこのREADMEでは概要を説明します。詳細については、[完全なドキュメント](https://googleapis.github.io/genai-toolbox/)をご覧ください。\n\n> \\[!NOTE] このソリューションは、当初の開発が MCP より前であったため、「Gen AI Toolbox for Databases」という名前でしたが、最近追加された MCP 互換性に合わせて名前が変更されました。\n\n## 目次\n\n* [なぜツールボックスなのか?](#why-toolbox)\n* [一般的なアーキテクチャ](#general-architecture)\n* [はじめる](#getting-started)\n\n * [サーバーのインストール](#installing-the-server)\n * [サーバーの実行](#running-the-server)\n * [アプリケーションの統合](#integrating-your-application)\n* [構成](#configuration)\n\n * [出典](#sources)\n * [ツール](#tools)\n * [ツールセット](#toolsets)\n* [バージョン管理](#versioning)\n* [貢献](#contributing)\n\n## なぜツールボックスなのか?\n\nToolbox は、エージェントがデータベース内のデータにアクセスできるようにする Gen AI ツールの構築に役立ちます。Toolbox には以下の機能があります。\n\n* **開発の簡素化**: 10 行未満のコードでエージェントにツールを統合し、複数のエージェントまたはフレームワーク間でツールを再利用し、新しいバージョンのツールをより簡単に展開できます。\n* **パフォーマンスの向上**: 接続プール、認証などのベストプラクティス。\n* **強化されたセキュリティ**: 統合認証により、データへのより安全なアクセスが可能\n* **エンドツーエンドの可観測性**: OpenTelemetry の組み込みサポートを備えた、すぐに使用できるメトリックとトレース。\n\n## 一般的なアーキテクチャ\n\nToolboxは、アプリケーションのオーケストレーションフレームワークとデータベースの間に位置し、ツールの変更、配布、呼び出しに使用するコントロールプレーンを提供します。ツールの保存と更新を一元的に行えるため、ツールの管理が簡素化されます。これにより、エージェントやアプリケーション間でツールを共有し、アプリケーションを再デプロイすることなくツールを更新できます。\n\n![建築](./docs/en/getting-started/introduction/architecture.png)\n\n## はじめる\n\n### サーバーのインストール\n\n最新バージョンについては、[リリースページ](https://github.com/googleapis/genai-toolbox/releases)を確認し、OS と CPU アーキテクチャに応じて次の手順に従ってください。\n\nToolbox をバイナリとしてインストールするには:\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ncurl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox\nchmod +x toolbox\n```\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\nソースからインストールするには、最新バージョンの[Go がインストールされて](https://go.dev/doc/install)いることを確認してから、次のコマンドを実行します。\n\n```sh\ngo install github.com/googleapis/genai-toolbox@v0.5.0\n```\n\n### サーバーの実行\n\nツールを定義するために`tools.yaml`[を設定し](#configuration)、 `toolbox`を実行してサーバーを起動します。\n\n```sh\n./toolbox --tools-file \"tools.yaml\"\n```\n\nフラグの完全なリストについては、 `toolbox help`を参照してください。サーバーを停止するには、終了信号を送信します (ほとんどのプラットフォームでは`ctrl+c` )。\n\nさまざまな環境への展開に関する詳細なドキュメントについては、 [「ハウツー」セクション](https://googleapis.github.io/genai-toolbox/how-to/)のリソースを参照してください。\n\n### アプリケーションの統合\n\nサーバーが起動したら、アプリケーションにツールをロードできます。各種フレームワークを使用するためのクライアントSDKのリストは以下をご覧ください。\n\n1. [Toolbox Core SDK](https://pypi.org/project/toolbox-core/)をインストールします:\n\n ```bash\n pip install toolbox-core\n ```\n\n2. ロードツール:\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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\nToolbox Core SDK の使用に関する詳細な手順については、 [プロジェクトの README を](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md)参照してください。\n\n1. [Toolbox LangChain SDK](https://pypi.org/project/toolbox-langchain/)をインストールします:\n\n ```bash\n pip install toolbox-langchain\n ```\n\n2. ロードツール:\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nToolbox LangChain SDK の使用に関する詳細な手順については、 [プロジェクトの README を](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md)参照してください。\n\n1. [Toolbox Llamaindex SDK](https://pypi.org/project/toolbox-llamaindex/)をインストールします:\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n2. ロードツール:\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nToolbox Llamaindex SDK の使用に関する詳細な手順については、[プロジェクトの README を](https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md)参照してください。\n\n## 構成\n\nToolbox を設定する主な方法は、 `tools.yaml`ファイルを使用することです。複数のファイルがある場合は、 `--tools-file tools.yaml`フラグを使用して、どのファイルを読み込むかを Toolbox に指示できます。\n\nすべてのリソースタイプに関する詳細なリファレンスドキュメントは、「[リソース」](https://googleapis.github.io/genai-toolbox/resources/)に記載されています。\n\n### 出典\n\n`tools.yaml`の`sources`セクションでは、ツールボックスがアクセスできるデータソースを定義します。ほとんどのツールには、実行対象となるソースが少なくとも 1 つあります。\n\n```yaml\nsources:\n my-pg-source:\n kind: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n```\n\nさまざまなタイプのソースの構成の詳細については、 [「ソース」を](https://googleapis.github.io/genai-toolbox/resources/sources)参照してください。\n\n### ツール\n\n`tools.yaml`の`tools`セクションでは、エージェントが実行できるアクション (ツールの種類、影響を受けるソース、使用するパラメーターなど) を定義します。\n\n```yaml\ntools:\n search-hotels-by-name:\n kind: postgres-sql\n source: my-pg-source\n description: Search for hotels based on name.\n parameters:\n - name: name\n type: string\n description: The name of the hotel.\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\nさまざまな種類のツールの構成の詳細については、 [「ツール」を](https://googleapis.github.io/genai-toolbox/resources/tools)参照してください。\n\n### ツールセット\n\n`tools.yaml`の`toolsets`セクションでは、まとめてロードしたいツールのグループを定義できます。これは、エージェントやアプリケーションごとに異なるグループを定義する場合に便利です。\n\n```yaml\ntoolsets:\n my_first_toolset:\n - my_first_tool\n - my_second_tool\n my_second_toolset:\n - my_second_tool\n - my_third_tool\n```\n\nツールセットを名前で読み込むことができます:\n\n```python\n# This will load all tools\nall_tools = client.load_toolset()\n\n# This will only load the tools listed in 'my_second_toolset'\nmy_second_toolset = client.load_toolset(\"my_second_toolset\")\n```\n\n## バージョン管理\n\nこのプロジェクトでは、次の値で増加する`MAJOR.MINOR.PATCH`バージョン番号を含む[セマンティックバージョニング](https://semver.org/)を使用します。\n\n* 互換性のないAPIの変更を行った場合のメジャーバージョン\n* 下位互換性のある機能を追加した場合のマイナーバージョン\n* 後方互換性のあるバグ修正を行った場合のPATCHバージョン\n\nこれに適用されるパブリック API は、Toolbox に関連付けられた CLI、公式 SDK とのやり取り、および`tools.yaml`ファイル内の定義です。\n\n## 貢献\n\n貢献を歓迎します。まずは[「貢献」](CONTRIBUTING.md)をご覧ください。\n\nこのプロジェクトはコントリビューター行動規範に基づいてリリースされます。このプロジェクトに参加することにより、その規約を遵守することに同意したことになります。詳しくは[コントリビューター行動規範](CODE_OF_CONDUCT.md)をご覧ください。","Japanese","ja-JP",{"_29":62,"_33":66,"_38":67},{"_31":63,"_33":64,"_35":65},"데이터베이스를 위한 쉽고 빠르며 안전한 도구를 전문으로 하는 오픈소스 MCP 서버입니다.","데이터베이스용 MCP 도구 상자","![심벌 마크](./logo.png)\n\n# 데이터베이스용 MCP 도구 상자\n\n[![불화](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\\&logo=discord\\&logoColor=white)](https://discord.gg/Dmm69peqjh) [![고 성적표](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox)\n\n> \\[!NOTE] 데이터베이스용 MCP 도구 상자는 현재 베타 버전이며, 첫 번째 안정적인 릴리스(v1.0)가 나올 때까지 중요한 변경 사항이 있을 수 있습니다.\n\nMCP Toolbox for Databases는 데이터베이스용 오픈 소스 MCP 서버입니다. 연결 풀링, 인증 등의 복잡한 작업을 처리하여 도구를 더 쉽고, 빠르고, 안전하게 개발할 수 있도록 지원합니다.\n\n이 README는 간략한 개요를 제공합니다. 자세한 내용은 [전체 문서를](https://googleapis.github.io/genai-toolbox/) 참조하세요.\n\n> \\[!NOTE] 이 솔루션은 원래 MCP 이전에 개발되었기 때문에 \"Gen AI Toolbox for Databases\"라는 이름이었으나 최근 추가된 MCP 호환성에 맞춰 이름이 변경되었습니다.\n\n## 목차\n\n* [왜 툴박스인가?](#why-toolbox)\n* [일반 아키텍처](#general-architecture)\n* [시작하기](#getting-started)\n\n * [서버 설치](#installing-the-server)\n * [서버 실행](#running-the-server)\n * [애플리케이션 통합](#integrating-your-application)\n* [구성](#configuration)\n\n * [출처](#sources)\n * [도구](#tools)\n * [도구 세트](#toolsets)\n* [버전 관리](#versioning)\n* [기여하다](#contributing)\n\n## 왜 툴박스인가?\n\nToolbox는 상담원이 데이터베이스의 데이터에 접근할 수 있도록 하는 Gen AI 도구를 구축하는 데 도움을 줍니다. Toolbox는 다음과 같은 기능을 제공합니다.\n\n* **간소화된 개발** : 10줄 미만의 코드로 에이전트에 도구를 통합하고, 여러 에이전트나 프레임워크 간에 도구를 재사용하고, 새로운 버전의 도구를 보다 쉽게 배포합니다.\n* **더 나은 성능** : 연결 풀링, 인증 등의 모범 사례.\n* **강화된 보안** : 데이터에 대한 보다 안전한 액세스를 위한 통합 인증\n* **종단 간 관찰성** : OpenTelemetry에 대한 기본 지원을 통해 즉시 사용 가능한 메트릭과 추적 기능을 제공합니다.\n\n## 일반 아키텍처\n\nToolbox는 애플리케이션의 오케스트레이션 프레임워크와 데이터베이스 사이에 위치하여 도구를 수정, 배포 또는 호출하는 데 사용되는 제어 영역을 제공합니다. 도구를 저장하고 업데이트할 수 있는 중앙 집중식 위치를 제공하여 도구 관리를 간소화하고, 에이전트와 애플리케이션 간에 도구를 공유하고 애플리케이션을 다시 배포하지 않고도 도구를 업데이트할 수 있도록 지원합니다.\n\n![건축학](./docs/en/getting-started/introduction/architecture.png)\n\n## 시작하기\n\n### 서버 설치\n\n최신 버전을 확인하려면 [릴리스 페이지를](https://github.com/googleapis/genai-toolbox/releases) 확인하고 OS 및 CPU 아키텍처에 맞는 다음 지침을 따르세요.\n\nToolbox를 바이너리로 설치하려면:\n\n지엑스피1\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\n소스에서 설치하려면 최신 버전의 [Go가 설치되어](https://go.dev/doc/install) 있는지 확인한 후 다음 명령을 실행하세요.\n\n```sh\ngo install github.com/googleapis/genai-toolbox@v0.5.0\n```\n\n### 서버 실행\n\n`tools.yaml` [구성하여](#configuration) 도구를 정의한 다음, `toolbox` 실행하여 서버를 시작합니다.\n\n```sh\n./toolbox --tools-file \"tools.yaml\"\n```\n\n전체 플래그 목록은 `toolbox help` 참조하세요! 서버를 중지하려면 종료 신호를 보내세요(대부분 플랫폼에서 `ctrl+c` ).\n\n다양한 환경에 배포하는 방법에 대한 자세한 설명서는 [방법 섹션](https://googleapis.github.io/genai-toolbox/how-to/) 의 리소스를 확인하세요.\n\n### 애플리케이션 통합\n\n서버가 가동되면 도구를 애플리케이션에 로드할 수 있습니다. 다양한 프레임워크를 사용할 수 있는 클라이언트 SDK 목록은 아래에서 확인하세요.\n\n1. [Toolbox Core SDK](https://pypi.org/project/toolbox-core/) 설치:\n\n ```bash\n pip install toolbox-core\n ```\n\n2. 도구 로드:\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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\nToolbox Core SDK 사용에 대한 자세한 지침은 해당 [프로젝트의 README를](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md) 참조하세요.\n\n1. [Toolbox LangChain SDK](https://pypi.org/project/toolbox-langchain/) 설치:\n\n ```bash\n pip install toolbox-langchain\n ```\n\n2. 도구 로드:\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nToolbox LangChain SDK 사용에 대한 자세한 지침은 해당 [프로젝트의 README를](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md) 참조하세요.\n\n1. [Toolbox Llamaindex SDK](https://pypi.org/project/toolbox-llamaindex/) 설치:\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n2. 도구 로드:\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nToolbox Llamaindex SDK 사용에 대한 자세한 지침은 해당 [프로젝트의 README를](https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md) 참조하세요.\n\n## 구성\n\nToolbox를 구성하는 기본 방법은 `tools.yaml` 파일을 사용하는 것입니다. 파일이 여러 개인 경우, `--tools-file tools.yaml` 플래그를 사용하여 Toolbox에 어떤 파일을 로드할지 지정할 수 있습니다.\n\n모든 리소스 유형에 대한 더 자세한 참조 문서는 [리소스](https://googleapis.github.io/genai-toolbox/resources/) 에서 찾을 수 있습니다.\n\n### 출처\n\n`tools.yaml` 파일의 `sources` 섹션은 도구 상자가 접근할 수 있는 데이터 소스를 정의합니다. 대부분의 도구에는 실행할 소스가 하나 이상 있습니다.\n\n```yaml\nsources:\n my-pg-source:\n kind: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n```\n\n다양한 유형의 소스를 구성하는 방법에 대한 자세한 내용은 [소스를](https://googleapis.github.io/genai-toolbox/resources/sources) 참조하세요.\n\n### 도구\n\n`tools.yaml` 의 `tools` 섹션은 에이전트가 취할 수 있는 작업을 정의합니다. 즉, 어떤 종류의 도구인지, 어떤 소스에 영향을 미치는지, 어떤 매개변수를 사용하는지 등을 정의합니다.\n\n```yaml\ntools:\n search-hotels-by-name:\n kind: postgres-sql\n source: my-pg-source\n description: Search for hotels based on name.\n parameters:\n - name: name\n type: string\n description: The name of the hotel.\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\n다양한 유형의 도구를 구성하는 방법에 대한 자세한 내용은 [도구를](https://googleapis.github.io/genai-toolbox/resources/tools) 참조하세요.\n\n### 도구 세트\n\n`tools.yaml` 파일의 `toolsets` 섹션을 사용하면 함께 로드할 도구 그룹을 정의할 수 있습니다. 이는 에이전트나 애플리케이션별로 다른 그룹을 정의하는 데 유용할 수 있습니다.\n\n```yaml\ntoolsets:\n my_first_toolset:\n - my_first_tool\n - my_second_tool\n my_second_toolset:\n - my_second_tool\n - my_third_tool\n```\n\n이름으로 도구 세트를 로드할 수 있습니다.\n\n```python\n# This will load all tools\nall_tools = client.load_toolset()\n\n# This will only load the tools listed in 'my_second_toolset'\nmy_second_toolset = client.load_toolset(\"my_second_toolset\")\n```\n\n## 버전 관리\n\n이 프로젝트에서는 `MAJOR.MINOR.PATCH` 버전 번호를 포함하여 다음과 같이 증가하는 [의미적 버전을](https://semver.org/) 사용합니다.\n\n* 호환되지 않는 API 변경을 할 경우 MAJOR 버전\n* 이전 버전과 호환되는 방식으로 기능을 추가할 때 MINOR 버전\n* 이전 버전과 호환되는 버그 수정을 할 때 패치 버전을 제공합니다.\n\n이것이 적용되는 공개 API는 Toolbox와 관련된 CLI, 공식 SDK와의 상호작용, `tools.yaml` 파일의 정의입니다.\n\n## 기여하다\n\n기여를 환영합니다. 시작하려면 [CONTRIBUTING을](CONTRIBUTING.md) 참조하세요.\n\n이 프로젝트는 기여자 행동 강령을 준수합니다. 이 프로젝트에 참여함으로써 귀하는 해당 약관을 준수하는 데 동의하게 됩니다. 자세한 내용은 [기여자 행동 강령을](CODE_OF_CONDUCT.md) 참조하세요.","Korean","ko-KR",{"_29":69,"_33":73,"_38":74},{"_31":70,"_33":71,"_35":72},"MCP-сервер с открытым исходным кодом, специализирующийся на простых, быстрых и безопасных инструментах для баз данных.","Набор инструментов MCP для баз данных","![логотип](./logo.png)\n\n# Набор инструментов MCP для баз данных\n\n[![Раздор](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\\&logo=discord\\&logoColor=white)](https://discord.gg/Dmm69peqjh) [![Перейти Отчетная Карточка](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox)\n\n> \\[!ПРИМЕЧАНИЕ] MCP Toolbox for Databases в настоящее время находится в стадии бета-тестирования и может претерпеть критические изменения до выхода первой стабильной версии (v1.0).\n\nMCP Toolbox for Databases — это сервер MCP с открытым исходным кодом для баз данных. Он позволяет вам разрабатывать инструменты проще, быстрее и безопаснее, управляя сложностями, такими как пул соединений, аутентификация и т. д.\n\nЭтот README содержит краткий обзор. Для получения подробных сведений см. [полную документацию](https://googleapis.github.io/genai-toolbox/) .\n\n> \\[!ПРИМЕЧАНИЕ] Первоначально это решение называлось «Gen AI Toolbox for Databases», поскольку его первоначальная разработка предшествовала MCP, но было переименовано для соответствия недавно добавленной совместимости с MCP.\n\n## Оглавление\n\n* [Почему именно «Ящик для инструментов»?](#why-toolbox)\n* [Общая Архитектура](#general-architecture)\n* [Начиная](#getting-started)\n\n * [Установка сервера](#installing-the-server)\n * [Запуск сервера](#running-the-server)\n * [Интеграция вашего приложения](#integrating-your-application)\n* [Конфигурация](#configuration)\n\n * [Источники](#sources)\n * [Инструменты](#tools)\n * [Наборы инструментов](#toolsets)\n* [Версионирование](#versioning)\n* [Внося вклад](#contributing)\n\n## Почему именно «Ящик для инструментов»?\n\nToolbox помогает вам создавать инструменты Gen AI, которые позволяют вашим агентам получать доступ к данным в вашей базе данных. Toolbox предоставляет:\n\n* **Упрощенная разработка** : интегрируйте инструменты в свой агент менее чем в 10 строк кода, повторно используйте инструменты между несколькими агентами или фреймворками и с легкостью развертывайте новые версии инструментов.\n* **Лучшая производительность** : лучшие практики, такие как пул соединений, аутентификация и многое другое.\n* **Повышенная безопасность** : интегрированная аутентификация для более безопасного доступа к вашим данным.\n* **Сквозное наблюдение** : готовые метрики и трассировка со встроенной поддержкой OpenTelemetry.\n\n## Общая Архитектура\n\nToolbox располагается между фреймворком оркестровки вашего приложения и вашей базой данных, предоставляя плоскость управления, которая используется для изменения, распространения или вызова инструментов. Он упрощает управление вашими инструментами, предоставляя вам централизованное место для хранения и обновления инструментов, позволяя вам совместно использовать инструменты между агентами и приложениями и обновлять эти инструменты без необходимости повторного развертывания вашего приложения.\n\n![архитектура](./docs/en/getting-started/introduction/architecture.png)\n\n## Начиная\n\n### Установка сервера\n\nДля получения последней версии посетите [страницу релизов](https://github.com/googleapis/genai-toolbox/releases) и следуйте следующим инструкциям для вашей ОС и архитектуры ЦП.\n\nЧтобы установить Toolbox как двоичный файл:\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ncurl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox\nchmod +x toolbox\n```\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\nДля установки из исходного кода убедитесь, что у вас [установлена последняя версия Go](https://go.dev/doc/install) , а затем выполните следующую команду:\n\n```sh\ngo install github.com/googleapis/genai-toolbox@v0.5.0\n```\n\n### Запуск сервера\n\n[Настройте](#configuration) `tools.yaml` для определения ваших инструментов, а затем выполните `toolbox` для запуска сервера:\n\n```sh\n./toolbox --tools-file \"tools.yaml\"\n```\n\nВы можете использовать `toolbox help` для получения полного списка флагов! Чтобы остановить сервер, отправьте сигнал завершения ( `ctrl+c` на большинстве платформ).\n\nБолее подробную документацию по развертыванию в различных средах можно найти в [разделе «Как это сделать».](https://googleapis.github.io/genai-toolbox/how-to/)\n\n### Интеграция вашего приложения\n\nПосле того, как ваш сервер запущен и работает, вы можете загрузить инструменты в свое приложение. Ниже приведен список клиентских SDK для использования различных фреймворков:\n\n1. Установить [Toolbox Core SDK](https://pypi.org/project/toolbox-core/) :\n\n ```bash\n pip install toolbox-core\n ```\n\n2. Загрузить инструменты:\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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\nБолее подробные инструкции по использованию Toolbox Core SDK см. [в файле README проекта](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md) .\n\n1. Установите [Toolbox LangChain SDK](https://pypi.org/project/toolbox-langchain/) :\n\n ```bash\n pip install toolbox-langchain\n ```\n\n2. Загрузить инструменты:\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nБолее подробные инструкции по использованию Toolbox LangChain SDK см. [в файле README проекта](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md) .\n\n1. Установите [Toolbox Llamaindex SDK](https://pypi.org/project/toolbox-llamaindex/) :\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n2. Загрузить инструменты:\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\nБолее подробные инструкции по использованию Toolbox Llamaindex SDK см. [в файле README проекта](https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md) .\n\n## Конфигурация\n\nОсновной способ настройки Toolbox — через файл `tools.yaml` . Если у вас несколько файлов, вы можете указать toolbox, какой из них загружать, с помощью флага `--tools-file tools.yaml` .\n\nБолее подробную справочную документацию по всем типам ресурсов вы можете найти в [разделе Ресурсы](https://googleapis.github.io/genai-toolbox/resources/) .\n\n### Источники\n\nРаздел `sources` вашего `tools.yaml` определяет, к каким источникам данных должен иметь доступ ваш Toolbox. Большинство инструментов будут иметь по крайней мере один источник для выполнения.\n\n```yaml\nsources:\n my-pg-source:\n kind: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n```\n\nБолее подробную информацию о настройке различных типов источников см. в [разделе Источники](https://googleapis.github.io/genai-toolbox/resources/sources) .\n\n### Инструменты\n\nРаздел `tools` файла `tools.yaml` определяет действия, которые может выполнять агент: какой это тип инструмента, на какие источники он влияет, какие параметры он использует и т. д.\n\n```yaml\ntools:\n search-hotels-by-name:\n kind: postgres-sql\n source: my-pg-source\n description: Search for hotels based on name.\n parameters:\n - name: name\n type: string\n description: The name of the hotel.\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\nБолее подробную информацию о настройке различных типов инструментов см. в [разделе Инструменты](https://googleapis.github.io/genai-toolbox/resources/tools) .\n\n### Наборы инструментов\n\nРаздел `toolsets` вашего `tools.yaml` позволяет вам определять группы инструментов, которые вы хотите загружать вместе. Это может быть полезно для определения различных групп на основе агента или приложения.\n\n```yaml\ntoolsets:\n my_first_toolset:\n - my_first_tool\n - my_second_tool\n my_second_toolset:\n - my_second_tool\n - my_third_tool\n```\n\nВы можете загрузить наборы инструментов по имени:\n\n```python\n# This will load all tools\nall_tools = client.load_toolset()\n\n# This will only load the tools listed in 'my_second_toolset'\nmy_second_toolset = client.load_toolset(\"my_second_toolset\")\n```\n\n## Версионирование\n\nВ этом проекте используется [семантическое управление версиями](https://semver.org/) , включая номер версии `MAJOR.MINOR.PATCH` , который увеличивается с:\n\n* ОСНОВНАЯ версия, когда мы вносим несовместимые изменения API\n* МИНОРНАЯ версия, когда мы добавляем функциональность с обратной совместимостью\n* Версия PATCH, когда мы делаем обратно совместимые исправления ошибок\n\nПубличный API, к которому это применяется, — это CLI, связанный с Toolbox, взаимодействие с официальными SDK и определения в файле `tools.yaml` .\n\n## Внося вклад\n\nВклады приветствуются. Пожалуйста, ознакомьтесь с разделом [ВКЛАД](CONTRIBUTING.md) , чтобы начать.\n\nОбратите внимание, что этот проект выпущен с Кодексом поведения участника. Участвуя в этом проекте, вы соглашаетесь соблюдать его условия. Для получения дополнительной информации см. [Кодекс поведения участника](CODE_OF_CONDUCT.md) .","Russian","ru-RU",{"_29":76,"_33":80,"_38":81},{"_31":77,"_33":78,"_35":79},"开源 MCP 服务器专门提供简单、快速、安全的数据库工具。","MCP 数据库工具箱","![标识](./logo.png)\n\n# MCP 数据库工具箱\n\n[![不和谐](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge\\&logo=discord\\&logoColor=white)](https://discord.gg/Dmm69peqjh) [![围棋成绩单](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox)\n\n> \\[!NOTE] MCP Toolbox for Databases 目前处于测试阶段，在第一个稳定版本（v1.0）发布之前可能会发生重大变化。\n\nMCP Toolbox for Databases 是一款开源的 MCP 数据库服务器。它能够处理诸如连接池、身份验证等复杂问题，让您能够更轻松、更快速、更安全地开发工具。\n\n本 README 提供简要概述。如需更详细的信息，请参阅[完整文档](https://googleapis.github.io/genai-toolbox/)。\n\n> \\[!NOTE] 该解决方案最初被命名为“数据库的 Gen AI 工具箱”，因为其初始开发早于 MCP，但后来被重新命名以符合最近添加的 MCP 兼容性。\n\n## 目录\n\n* [为什么选择工具箱？](#why-toolbox)\n* [总体架构](#general-architecture)\n* [入门](#getting-started)\n\n * [安装服务器](#installing-the-server)\n * [运行服务器](#running-the-server)\n * [集成您的应用程序](#integrating-your-application)\n* [配置](#configuration)\n\n * [来源](#sources)\n * [工具](#tools)\n * [工具集](#toolsets)\n* [版本控制](#versioning)\n* [贡献](#contributing)\n\n## 为什么选择工具箱？\n\nToolbox 可帮助您构建 Gen AI 工具，让您的代理能够访问数据库中的数据。Toolbox 提供以下功能：\n\n* **简化开发**：用不到 10 行代码将工具集成到您的代理中，在多个代理或框架之间重用工具，并更轻松地部署新版本的工具。\n* **更好的性能**：最佳实践，如连接池、身份验证等。\n* **增强的安全性**：集成身份验证，可更安全地访问您的数据\n* **端到端可观察性**：开箱即用的指标和跟踪，内置对 OpenTelemetry 的支持。\n\n## 总体架构\n\nToolbox 位于应用程序的编排框架和数据库之间，提供用于修改、分发或调用工具的控制平面。它通过为您提供一个集中存储和更新工具的位置，简化了工具的管理，使您可以在代理和应用程序之间共享工具，并更新这些工具，而无需重新部署应用程序。\n\n![建筑学](./docs/en/getting-started/introduction/architecture.png)\n\n## 入门\n\n### 安装服务器\n\n要获取最新版本，请查看[发布页面](https://github.com/googleapis/genai-toolbox/releases)并按照以下适合您的操作系统和 CPU 架构的说明进行操作。\n\n要将 Toolbox 安装为二进制文件：\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ncurl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox\nchmod +x toolbox\n```\n\n```sh\n# see releases page for other versions\nexport VERSION=0.5.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\n要从源代码安装，请确保[安装了最新版本的 Go](https://go.dev/doc/install) ，然后运行以下命令：\n\n```sh\ngo install github.com/googleapis/genai-toolbox@v0.5.0\n```\n\n### 运行服务器\n\n[配置](#configuration)一个`tools.yaml`来定义你的工具，然后执行`toolbox`来启动服务器：\n\n```sh\n./toolbox --tools-file \"tools.yaml\"\n```\n\n您可以使用`toolbox help`查看完整的标志列表！要停止服务器，请发送终止信号（大多数平台上`ctrl+c` ）。\n\n有关部署到不同环境的更多详细文档，请查看[“操作方法”部分](https://googleapis.github.io/genai-toolbox/how-to/)中的资源\n\n### 集成您的应用程序\n\n服务器启动并运行后，您就可以将这些工具加载到应用程序中。请参阅以下用于使用各种框架的客户端 SDK 列表：\n\n1. 安装[Toolbox Core SDK](https://pypi.org/project/toolbox-core/) ：\n\n ```bash\n pip install toolbox-core\n ```\n\n2. 加载工具：\n\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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\n有关使用 Toolbox Core SDK 的更多详细说明，请参阅[项目的 README](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md) 。\n\n1. 安装[Toolbox LangChain SDK](https://pypi.org/project/toolbox-langchain/) ：\n\n ```bash\n pip install toolbox-langchain\n ```\n\n2. 加载工具：\n\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\n有关使用 Toolbox LangChain SDK 的更多详细说明，请参阅[项目的 README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md) 。\n\n1. 安装[工具箱 Llamaindex SDK](https://pypi.org/project/toolbox-llamaindex/) ：\n\n ```bash\n pip install toolbox-llamaindex\n ```\n\n2. 加载工具：\n\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application! \n tools = client.load_toolset()\n ```\n\n有关使用 Toolbox Llamaindex SDK 的更多详细说明，请参阅[项目的 README](https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md) 。\n\n## 配置\n\n配置 Toolbox 的主要方式是通过`tools.yaml`文件。如果您有多个文件，可以使用`--tools-file tools.yaml`参数告诉 Toolbox 加载哪个文件。\n\n您可以在[资源](https://googleapis.github.io/genai-toolbox/resources/)中找到所有资源类型的更详细的参考文档。\n\n### 来源\n\n`tools.yaml`中的`sources`部分定义了你的工具箱可以访问哪些数据源。大多数工具至少会有一个数据源可供执行。\n\n```yaml\nsources:\n my-pg-source:\n kind: postgres\n host: 127.0.0.1\n port: 5432\n database: toolbox_db\n user: toolbox_user\n password: my-password\n```\n\n有关配置不同类型源的更多详细信息，请参阅[源](https://googleapis.github.io/genai-toolbox/resources/sources)。\n\n### 工具\n\n`tools.yaml`的`tools`部分定义了代理可以采取的操作：它是什么类型的工具，它影响哪些源，它使用哪些参数等。\n\n```yaml\ntools:\n search-hotels-by-name:\n kind: postgres-sql\n source: my-pg-source\n description: Search for hotels based on name.\n parameters:\n - name: name\n type: string\n description: The name of the hotel.\n statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';\n```\n\n有关配置不同类型工具的更多详细信息，请参阅[工具](https://googleapis.github.io/genai-toolbox/resources/tools)。\n\n### 工具集\n\n`tools.yaml`中的`toolsets`部分允许您定义需要同时加载的工具组。这对于根据代理或应用程序定义不同的工具组非常有用。\n\n```yaml\ntoolsets:\n my_first_toolset:\n - my_first_tool\n - my_second_tool\n my_second_toolset:\n - my_second_tool\n - my_third_tool\n```\n\n您可以按名称加载工具集：\n\n```python\n# This will load all tools\nall_tools = client.load_toolset()\n\n# This will only load the tools listed in 'my_second_toolset'\nmy_second_toolset = client.load_toolset(\"my_second_toolset\")\n```\n\n## 版本控制\n\n该项目使用[语义版本控制](https://semver.org/)，包括`MAJOR.MINOR.PATCH`版本号，其递增如下：\n\n* 当我们进行不兼容的 API 更改时，主要版本\n* 当我们以向后兼容的方式添加功能时，次版本\n* 当我们进行向后兼容的错误修复时，PATCH 版本\n\n适用的公共 API 是与 Toolbox 关联的 CLI、与官方 SDK 的交互以及`tools.yaml`文件中的定义。\n\n## 贡献\n\n欢迎贡献。请参阅[贡献部分](CONTRIBUTING.md)开始。\n\n请注意，本项目已发布贡献者行为准则。参与本项目即表示您同意遵守其条款。更多信息，请参阅[贡献者行为准则](CODE_OF_CONDUCT.md)。","Chinese","zh-CN","githubUser","locale",{"_85":86,"_87":88,"_13":101,"_107":42,"_108":42,"_109":110,"_114":115,"_137":-5,"_16":138,"_139":140,"_141":142,"_33":43,"_167":127,"_168":-5,"_169":-5,"_170":-5,"_171":-5,"_172":173,"_178":-5,"_149":123,"_179":180,"_182":-5,"_128":183,"_184":185},"addedAt","2025-04-09T01:51:34.549549851Z","argumentsJsonSchema",{"_89":90,"_98":99,"_96":100},"properties",{"_91":92},"tools_file",{"_93":94,"_31":95,"_96":97},"default","tools.yaml","Path to the tools.yaml configuration file defining your tools, sources and toolsets","type","string","required",[],"object",[102,103,104,105,106],"category:databases","category:developer-tools","hosting:remote-capable","language:go","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":111,"_112":113},"![logo](./logo.png)\n\n# MCP Toolbox for Databases\n\n[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/Dmm69peqjh)\n[![Go Report Card](https://goreportcard.com/badge/github.com/googleapis/genai-toolbox)](https://goreportcard.com/report/github.com/googleapis/genai-toolbox)\n\n> [!NOTE]\n> MCP Toolbox for Databases is currently in beta, and may see breaking\n> changes until the first stable release (v1.0).\n\nMCP Toolbox for Databases is an open source MCP server for databases. It enables\nyou to develop tools easier, faster, and more securely by handling the complexities\nsuch as connection pooling, authentication, and more.\n\nThis README provides a brief overview. For comprehensive details, see the [full\ndocumentation](https://googleapis.github.io/genai-toolbox/).\n\n\n> [!NOTE]\n> This solution was originally named “Gen AI Toolbox for Databases” as\n> its initial development predated MCP, but was renamed to align with recently\n> added MCP compatibility.\n\n\n## Table of Contents\n\n\n\n- [Why Toolbox?](#why-toolbox)\n- [General Architecture](#general-architecture)\n- [Getting Started](#getting-started)\n - [Installing the server](#installing-the-server)\n - [Running the server](#running-the-server)\n - [Integrating your application](#integrating-your-application)\n- [Configuration](#configuration)\n - [Sources](#sources)\n - [Tools](#tools)\n - [Toolsets](#toolsets)\n- [Versioning](#versioning)\n- [Contributing](#contributing)\n\n\n\n\n## Why Toolbox?\n\nToolbox helps you build Gen AI tools that let your agents access data in your\ndatabase. Toolbox provides:\n- **Simplified development**: Integrate tools to your agent in less than 10\n lines of code, reuse tools between multiple agents or frameworks, and deploy\n new versions of tools more easily.\n- **Better performance**: Best practices such as connection pooling,\n authentication, and more.\n- **Enhanced security**: Integrated auth for more secure access to your data\n- **End-to-end observability**: Out of the box metrics and tracing with built-in\n support for OpenTelemetry.\n\n\n**⚡ Supercharge Your Workflow with an AI Database Assistant ⚡**\n\nStop context-switching and let your AI assistant become a true co-developer. By [connecting your IDE to your databases with MCP Toolbox][connect-ide], you can delegate complex and time-consuming database tasks, allowing you to build faster and focus on what matters. This isn't just about code completion; it's about giving your AI the context it needs to handle the entire development lifecycle.\n\nHere’s how it will save you time:\n\n* **Query in Plain English**: Interact with your data using natural language right from your IDE. Ask complex questions like, *\"How many orders were delivered in 2024, and what items were in them?\"* without writing any SQL.\n* **Automate Database Management**: Simply describe your data needs, and let the AI assistant manage your database for you. It can handle generating queries, creating tables, adding indexes, and more.\n* **Generate Context-Aware Code**: Empower your AI assistant to generate application code and tests with a deep understanding of your real-time database schema. This accelerates the development cycle by ensuring the generated code is directly usable.\n* **Slash Development Overhead**: Radically reduce the time spent on manual setup and boilerplate. MCP Toolbox helps streamline lengthy database configurations, repetitive code, and error-prone schema migrations.\n\nLearn [how to connect your AI tools (IDEs) to Toolbox using MCP][connect-ide].\n\n[connect-ide]: https://googleapis.github.io/genai-toolbox/how-to/connect-ide/\n\n## General Architecture\n\nToolbox sits between your application's orchestration framework and your\ndatabase, providing a control plane that is used to modify, distribute, or\ninvoke tools. It simplifies the management of your tools by providing you with a\ncentralized location to store and update tools, allowing you to share tools\nbetween agents and applications and update those tools without necessarily\nredeploying your application.\n\n![architecture](./docs/en/getting-started/introduction/architecture.png)\n\n## Getting Started\n\n### Installing the server\nFor the latest version, check the [releases page][releases] and use the\nfollowing instructions for your OS and CPU architecture.\n\n[releases]: https://github.com/googleapis/genai-toolbox/releases\n\n

Binary

\n\nTo install Toolbox as a binary:\n\n\n```sh\n# see releases page for other versions\nexport VERSION=0.6.0\ncurl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox\nchmod +x toolbox\n```\n\n

\n\n

Container image

\nYou can also install Toolbox as a container:\n\n```sh\n# see releases page for other versions\nexport VERSION=0.6.0\ndocker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION\n```\n\n

\n\n

Compile from source

Core

\n\n1. Install [Toolbox Core SDK][toolbox-core]:\n ```bash\n pip install toolbox-core\n ```\n1. Load tools:\n ```python\n from toolbox_core import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.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://pypi.org/project/toolbox-core/\n[toolbox-core-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core/README.md\n\n

LangChain / LangGraph

\n\n1. Install [Toolbox LangChain SDK][toolbox-langchain]:\n ```bash\n pip install toolbox-langchain\n ```\n1. Load tools:\n ```python\n from toolbox_langchain import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = client.load_toolset()\n ```\n\nFor more detailed instructions on using the Toolbox LangChain SDK, see the\n[project's README][toolbox-langchain-readme].\n\n[toolbox-langchain]: https://pypi.org/project/toolbox-langchain/\n[toolbox-langchain-readme]: https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md\n\n

\n\n

LlamaIndex

\n\n1. Install [Toolbox Llamaindex SDK][toolbox-llamaindex]:\n ```bash\n pip install toolbox-llamaindex\n ```\n1. Load tools:\n ```python\n from toolbox_llamaindex import ToolboxClient\n\n # update the url to point to your server\n async with ToolboxClient(\"http://127.0.0.1:5000\") as client:\n\n # these tools can be passed to your application!\n tools = client.load_toolset()\n ```\n\nFor more detailed instructions on using the Toolbox Llamaindex SDK, see the\n[project's README][toolbox-llamaindex-readme].\n\n[toolbox-llamaindex]: https://pypi.org/project/toolbox-llamaindex/\n[toolbox-llamaindex-readme]: https://github.com/googleapis/genai-toolbox-llamaindex-python/blob/main/README.md\n\n

Rate & Review

MCP directory API