# MCP Toolbox for Databases

> 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.

## Docs

### Getting Started

How to get started with Toolbox.
- [Introduction](https://googleapis.github.io/genai-toolbox/getting-started/introduction/): An introduction to MCP Toolbox for Databases.
- [Quickstart (Local)](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart/): How to get started running Toolbox locally with Python, PostgreSQL, and  [Agent Development Kit](https://google.github.io/adk-docs/), [LangGraph](https://www.langchain.com/langgraph), [LlamaIndex](https://www.llamaindex.ai/) or [GoogleGenAI](https://pypi.org/project/google-genai/).
- [Quickstart (MCP)](https://googleapis.github.io/genai-toolbox/getting-started/mcp_quickstart/): How to get started running Toolbox locally with MCP Inspector. 
- [Configuration](https://googleapis.github.io/genai-toolbox/getting-started/configure/): How to configure Toolbox's tools.yaml file.

### Concepts

Some core concepts in Toolbox
- [Telemetry](https://googleapis.github.io/genai-toolbox/concepts/telemetry/): An overview of telemetry and observability in Toolbox. 

### How-to

List of guides detailing how to do different things with Toolbox. 
- [Connect from your IDE](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/): List of guides detailing how to connect your AI tools (IDEs) to Toolbox using MCP.
  - [AlloyDB using MCP](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/alloydb_pg_mcp/): Connect your IDE to AlloyDB using Toolbox.
  - [BigQuery using MCP](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/bigquery_mcp/): Connect your IDE to BigQuery using Toolbox.
  - [Cloud SQL for MySQL using MCP](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/cloud_sql_mysql_mcp/): Connect your IDE to Cloud SQL for MySQL using Toolbox.
  - [Cloud SQL for Postgres using MCP](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/cloud_sql_pg_mcp/): Connect your IDE to Cloud SQL for Postgres using Toolbox.
  - [Cloud SQL for SQL Server using MCP](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/cloud_sql_mssql_mcp/): Connect your IDE to Cloud SQL for SQL Server using Toolbox.
  - [PostgreSQL using MCP](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/postgres_mcp/): Connect your IDE to PostgreSQL using Toolbox.
  - [Spanner using MCP](https://googleapis.github.io/genai-toolbox/how-to/connect-ide/spanner_mcp/): Connect your IDE to Spanner using Toolbox.
- [Connect via MCP Client](https://googleapis.github.io/genai-toolbox/how-to/connect_via_mcp/): How to connect to Toolbox from a MCP Client.
- [Deploy to Cloud Run](https://googleapis.github.io/genai-toolbox/how-to/deploy_toolbox/): How to set up and configure Toolbox to run on Cloud Run.
- [Deploy to Kubernetes](https://googleapis.github.io/genai-toolbox/how-to/deploy_gke/): How to set up and configure Toolbox to deploy on Kubernetes with Google Kubernetes Engine (GKE).
- [Deploy using Docker Compose](https://googleapis.github.io/genai-toolbox/how-to/deploy_docker/): How to deploy Toolbox using Docker Compose.
- [Export Telemetry](https://googleapis.github.io/genai-toolbox/how-to/export_telemetry/): How to set up and configure Toolbox to use the Otel Collector.

### Resources

List of reference documentation for resources in Toolbox.
- [AuthServices](https://googleapis.github.io/genai-toolbox/resources/authservices/): AuthServices represent services that handle authentication and authorization. 
  - [Google Sign-In](https://googleapis.github.io/genai-toolbox/resources/authservices/google/): Use Google Sign-In for Oauth 2.0 flow and token lifecycle. 
- [Sources](https://googleapis.github.io/genai-toolbox/resources/sources/): Sources represent your different data sources that a tool can interact with.
  - [AlloyDB for PostgreSQL](https://googleapis.github.io/genai-toolbox/resources/sources/alloydb-pg/): AlloyDB for PostgreSQL is a fully-managed, PostgreSQL-compatible database for  demanding transactional workloads.
  - [BigQuery](https://googleapis.github.io/genai-toolbox/resources/sources/bigquery/): BigQuery is Google Cloud's fully managed, petabyte-scale, and cost-effective analytics data warehouse that lets you run analytics over vast amounts of  data in near real time. With BigQuery, there's no infrastructure to set  up or manage, letting you focus on finding meaningful insights using  GoogleSQL and taking advantage of flexible pricing models across on-demand  and flat-rate options.
  - [Bigtable](https://googleapis.github.io/genai-toolbox/resources/sources/bigtable/): Bigtable is a low-latency NoSQL database service for machine learning, operational analytics, and user-facing operations. It's a wide-column, key-value store that can scale to billions of rows and thousands of columns. With Bigtable, you can replicate your data to regions across the world for high availability and data resiliency.
  - [Cloud SQL for MySQL](https://googleapis.github.io/genai-toolbox/resources/sources/cloud-sql-mysql/): Cloud SQL for MySQL is a fully-managed database service for MySQL.
  - [Cloud SQL for PostgreSQL](https://googleapis.github.io/genai-toolbox/resources/sources/cloud-sql-pg/): Cloud SQL for PostgreSQL is a fully-managed database service for Postgres.
  - [Cloud SQL for SQL Server](https://googleapis.github.io/genai-toolbox/resources/sources/cloud-sql-mssql/): Cloud SQL for SQL Server is a fully-managed database service for SQL Server.
  - [couchbase](https://googleapis.github.io/genai-toolbox/resources/sources/couchbase/): A "couchbase" source connects to a Couchbase database.
  - [Dgraph](https://googleapis.github.io/genai-toolbox/resources/sources/dgraph/): Dgraph is fully open-source, built-for-scale graph database for Gen AI workloads
  - [HTTP](https://googleapis.github.io/genai-toolbox/resources/sources/http/): The HTTP source enables the Toolbox to retrieve data from a remote server using HTTP requests.
  - [MySQL](https://googleapis.github.io/genai-toolbox/resources/sources/mysql/): MySQL is a relational database management system that stores and manages data.
  - [Neo4j](https://googleapis.github.io/genai-toolbox/resources/sources/neo4j/): Neo4j is a powerful, open source graph database system
  - [PostgreSQL](https://googleapis.github.io/genai-toolbox/resources/sources/postgres/): PostgreSQL is a powerful, open source object-relational database.
  - [Redis](https://googleapis.github.io/genai-toolbox/resources/sources/redis/): Redis is an open-source, in-memory data structure store.
  - [Spanner](https://googleapis.github.io/genai-toolbox/resources/sources/spanner/): Spanner is a fully managed database service from Google Cloud that combines  relational, key-value, graph, and search capabilities.
  - [SQL Server](https://googleapis.github.io/genai-toolbox/resources/sources/mssql/): SQL Server is a relational database management system (RDBMS).
  - [SQLite](https://googleapis.github.io/genai-toolbox/resources/sources/sqlite/): SQLite is a C-language library that implements a small, fast, self-contained,  high-reliability, full-featured, SQL database engine.
  - [Valkey](https://googleapis.github.io/genai-toolbox/resources/sources/valkey/): Valkey is an open-source, in-memory data structure store, forked from Redis.
- [Tools](https://googleapis.github.io/genai-toolbox/resources/tools/): Tools define actions an agent can take -- such as reading and writing to a  source.
  - [AlloyDB AI NL](https://googleapis.github.io/genai-toolbox/resources/tools/alloydbainl/): AlloyDB AI NL Tool.
  - [BigQuery](https://googleapis.github.io/genai-toolbox/resources/tools/bigquery/): Tools that work with BigQuery Sources.
  - [Bigtable](https://googleapis.github.io/genai-toolbox/resources/tools/bigtable/): Tools that work with Bigtable Sources.
  - [Couchbase](https://googleapis.github.io/genai-toolbox/resources/tools/couchbase/): Tools that work with Couchbase Sources.
  - [Dgraph](https://googleapis.github.io/genai-toolbox/resources/tools/dgraph/): Tools that work with Dgraph Sources.
  - [HTTP](https://googleapis.github.io/genai-toolbox/resources/tools/http/): Tools that work with HTTP Sources.
  - [MySQL](https://googleapis.github.io/genai-toolbox/resources/tools/mysql/): Tools that work with MySQL Sources, such as Cloud SQL for MySQL.
  - [Neo4j](https://googleapis.github.io/genai-toolbox/resources/tools/neo4j/): Tools that work with Neo4j Sources.
  - [Postgres](https://googleapis.github.io/genai-toolbox/resources/tools/postgres/): Tools that work with Postgres Sources, such as Cloud SQL for Postgres and AlloyDB. 
  - [Redis](https://googleapis.github.io/genai-toolbox/resources/tools/redis/): Tools that work with Redis Sources.
  - [Spanner](https://googleapis.github.io/genai-toolbox/resources/tools/spanner/): Tools that work with Spanner Sources.
  - [SQL Server](https://googleapis.github.io/genai-toolbox/resources/tools/mssql/): Tools that work with SQL Server Sources, such as CloudSQL for SQL Server.
  - [SQLite](https://googleapis.github.io/genai-toolbox/resources/tools/sqlite/): Tools that work with SQLite Sources.
  - [Valkey](https://googleapis.github.io/genai-toolbox/resources/tools/valkey/): Tools that work with Valkey Sources.

### Samples

Samples and guides for using Toolbox.
- [BigQuery](https://googleapis.github.io/genai-toolbox/samples/bigquery/): How to get started with Toolbox using BigQuery.
  - [Quickstart (Local with BigQuery)](https://googleapis.github.io/genai-toolbox/samples/bigquery/local_quickstart/): How to get started running Toolbox locally with Python, BigQuery, and  LangGraph, LlamaIndex, or ADK.
  - [Quickstart (MCP with BigQuery)](https://googleapis.github.io/genai-toolbox/samples/bigquery/mcp_quickstart/): How to get started running Toolbox with MCP Inspector and BigQuery as the source.

### About

A list of other information related to Toolbox.
- [FAQ](https://googleapis.github.io/genai-toolbox/about/faq/): Frequently asked questions about Toolbox.
### SDKs

Client SDKs to connect to the MCP Toolbox server.
- [Go SDK](https://googleapis.github.io/genai-toolbox/sdks/go-sdk/): Go lang client SDK- [JS SDK](https://googleapis.github.io/genai-toolbox/sdks/js-sdk/): Javascript client SDK- [Python SDK](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/): Python client SDK