Enables integration with LangChain framework, allowing agents to leverage database tools and execute queries through the MCP Toolbox server.
Provides compatibility with LangGraph for building agent workflows that can access and manipulate database data using the tools defined in the MCP server.
Offers built-in support for OpenTelemetry, enabling end-to-end observability with metrics and tracing for database operations performed through the MCP server.
MCP Toolbox for Databases
Note
MCP Toolbox for Databases is currently in beta, and may see breaking changes until the first stable release (v1.0).
MCP Toolbox for Databases is an open source MCP server for databases. It enables you to develop tools easier, faster, and more securely by handling the complexities such as connection pooling, authentication, and more.
This README provides a brief overview. For comprehensive details, see the full documentation.
Note
This solution was originally named “Gen AI Toolbox for Databases” as its initial development predated MCP, but was renamed to align with recently added MCP compatibility.
Table of Contents
Why Toolbox?
Toolbox helps you build Gen AI tools that let your agents access data in your database. Toolbox provides:
- Simplified development: Integrate tools to your agent in less than 10 lines of code, reuse tools between multiple agents or frameworks, and deploy new versions of tools more easily.
- Better performance: Best practices such as connection pooling, authentication, and more.
- Enhanced security: Integrated auth for more secure access to your data
- End-to-end observability: Out of the box metrics and tracing with built-in support for OpenTelemetry.
⚡ Supercharge Your Workflow with an AI Database Assistant ⚡
Stop context-switching and let your AI assistant become a true co-developer. By connecting your IDE to your databases with MCP Toolbox, 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.
Here’s how it will save you time:
- 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.
- 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.
- 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.
- 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.
Learn how to connect your AI tools (IDEs) to Toolbox using MCP.
General Architecture
Toolbox sits between your application's orchestration framework and your database, providing a control plane that is used to modify, distribute, or invoke tools. It simplifies the management of your tools by providing you with a centralized location to store and update tools, allowing you to share tools between agents and applications and update those tools without necessarily redeploying your application.
Getting Started
Installing the server
For the latest version, check the releases page and use the following instructions for your OS and CPU architecture.
To install Toolbox as a binary:
To install Toolbox using Homebrew on macOS or Linux:
To install from source, ensure you have the latest version of Go installed, and then run the following command:
Running the server
Configure a tools.yaml
to define your tools, and then
execute toolbox
to start the server:
Note
Toolbox enables dynamic reloading by default. To disable, use the
--disable-reload
flag.
Homebrew Users
If you installed Toolbox using Homebrew, the toolbox
binary is available in your system path. You can start the server with the same command:
You can use toolbox help
for a full list of flags! To stop the server, send a
terminate signal (ctrl+c
on most platforms).
For more detailed documentation on deploying to different environments, check out the resources in the How-to section
Integrating your application
Once your server is up and running, you can load the tools into your application. See below the list of Client SDKs for using various frameworks:
- Install Toolbox Core SDK:
- Load tools:
For more detailed instructions on using the Toolbox Core SDK, see the project's README.
- Install Toolbox LangChain SDK:
- Load tools:For more detailed instructions on using the Toolbox LangChain SDK, see the project's README.
- Install Toolbox Llamaindex SDK:
- Load tools:For more detailed instructions on using the Toolbox Llamaindex SDK, see the project's README.
- Install Toolbox Core SDK:
- Load tools:For more detailed instructions on using the Toolbox Core SDK, see the project's README.
- Install Toolbox Core SDK:
- Load tools:
- Install Toolbox Core SDK:
- Load tools:
- Install Toolbox Go SDK:
- Load tools:For more detailed instructions on using the Toolbox Go SDK, see the project's README.
- Install Toolbox Go SDK:
- Load tools:
- Install Toolbox Go SDK:
- Load tools:
- Install Toolbox Go SDK:
- Load tools:
- Install Toolbox Go SDK:
- Load tools:
Configuration
The primary way to configure Toolbox is through the tools.yaml
file. If you
have multiple files, you can tell toolbox which to load with the --tools-file tools.yaml
flag.
You can find more detailed reference documentation to all resource types in the Resources.
Sources
The sources
section of your tools.yaml
defines what data sources your
Toolbox should have access to. Most tools will have at least one source to
execute against.
For more details on configuring different types of sources, see the Sources.
Tools
The tools
section of a tools.yaml
define the actions an agent can take: what
kind of tool it is, which source(s) it affects, what parameters it uses, etc.
For more details on configuring different types of tools, see the Tools.
Toolsets
The toolsets
section of your tools.yaml
allows you to define groups of tools
that you want to be able to load together. This can be useful for defining
different groups based on agent or application.
You can load toolsets by name:
Versioning
This project uses semantic versioning (MAJOR.MINOR.PATCH
).
Since the project is in a pre-release stage (version 0.x.y
), we follow the
standard conventions for initial development:
Pre-1.0.0 Versioning
While the major version is 0
, the public API should be considered unstable.
The version will be incremented as follows:
0.MINOR.PATCH
: The MINOR version is incremented when we add new functionality or make breaking, incompatible API changes.0.MINOR.PATCH
: The PATCH version is incremented for backward-compatible bug fixes.
Post-1.0.0 Versioning
Once the project reaches a stable 1.0.0
release, the versioning will follow
the more common convention:
MAJOR.MINOR.PATCH
: Incremented for incompatible API changes.MAJOR.MINOR.PATCH
: Incremented for new, backward-compatible functionality.MAJOR.MINOR.PATCH
: Incremented for backward-compatible bug fixes.
The public API that this applies to is the CLI associated with Toolbox, the
interactions with official SDKs, and the definitions in the tools.yaml
file.
Contributing
Contributions are welcome. Please, see the CONTRIBUTING to get started.
Please 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 for more information.
Community
Join our discord community to connect with our developers!
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Open source MCP server specializing in easy, fast, and secure tools for Databases.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.Last updated -15MIT License
- -securityFlicense-qualityAn MCP server that allows working with MySQL databases by providing tools for executing read-only SQL queries, getting table schemas, and listing database tables.Last updated -5962
- AsecurityAlicenseAqualityAn open-source MCP server that connects to various data sources (SQL databases, CSV, Parquet files), allowing AI models to execute SQL queries and generate data visualizations for analytics and business intelligence.Last updated -957MIT License
- AsecurityFlicenseAqualityA Python-based MCP server implementation that can be easily installed via pip or directly from GitHub, providing a simple way to deploy and run MCP server functionality.Last updated -1