# googleapis/mcp-toolbox

MCP Toolbox for Databases is an open source MCP server for databases.

Repository: https://github.com/googleapis/mcp-toolbox
Canonical: https://ross.abutalabs.com/products/mcp-toolbox
Homepage: https://mcp-toolbox.dev/documentation/introduction/
Language: Go
License: Apache-2.0
License Family: permissive
Topics: genai, mcp, agent, ai, database, llm, server, agents, bigquery, elasticsearch, firestore, mongodb, mysql, oracle, postgresql, spanner, clickhouse, redis, tidb, cockroachdb
Last push: 2026-08-27T00:19:29+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 97, longevity 58
- inputs: {"age_days": 817, "days_push": 7, "days_rel": 20, "gap_med": 14, "n_releases_24m": 48}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 16262, forks 1698 (observed 2026-08-28T04:11:15.005581+00:00)

## What it is
MCP Toolbox for Databases is an open source Model Context Protocol (MCP) server, written in Go, that connects AI agents, IDEs, and applications to enterprise databases. It offers prebuilt generic tools for instant data exploration plus a custom tools framework for defining secure, production-ready queries, semantic search, and NL2SQL capabilities via a tools.yaml configuration.

## Use cases
- connect Claude Code or Gemini CLI to my postgres database via MCP
- let an AI agent query BigQuery or Spanner safely
- build custom secure database tools for a production LLM agent
- explore database schemas and run SQL from my IDE with an MCP client
- add NL2SQL and semantic search tools to a LangChain or ADK agent
- expose MongoDB or Elasticsearch data to AI agents with authentication

## When to choose
- you want a ready-made MCP server bridging AI agents/IDEs and many database engines
- you need secure, parameterized, authenticated database tools for production agents
- you use Google Cloud databases (BigQuery, Spanner, Firestore) or popular engines like Postgres, MySQL, MongoDB, Redis
- you want connection pooling, IAM auth, and OpenTelemetry observability handled for you

## When to avoid
- you need a generic MCP server for non-database tools or APIs
- you want a lightweight embedded library rather than a separately deployed server
- your database engine is not among the supported sources
- you require fully arbitrary LLM-generated SQL in production without developer oversight

## Facets
- artifact type: service
- maturity: active
- function: mcp, database, agent-framework, api-framework, auth, monitoring, search-engine
- domain: databases, large-language-models, developer-tools, backend, self-hosted
- platform: windows, self-hosted, go, python, cli
- tags: mcp-server, database-tools, nl2sql, genai, tools-yaml, bigquery, postgresql, mysql, spanner, firestore, mongodb, elasticsearch, redis, clickhouse, langchain, adk, ai-agents, linux, macos, docker, nodejs

## Member repositories
- googleapis/mcp-toolbox (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:15.005581+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:05:09.909298+00:00, confidence not recorded.
  - readme: https://github.com/googleapis/mcp-toolbox (fetched 2026-08-28T04:11:15.005581+00:00, sha 316cdee452df)
  - homepage: https://mcp-toolbox.dev/documentation/introduction/ (fetched 2026-08-29T08:02:49.269376+00:00, sha 4476d708de13)
  - site_page: https://mcp-toolbox.dev/documentation (fetched 2026-08-29T08:02:49.279191+00:00, sha ea85d13fb4ad)
  - site_page: https://mcp-toolbox.dev/documentation/getting-started (fetched 2026-08-29T08:02:49.280921+00:00, sha 5136cbb67be2)
  - site_page: https://mcp-toolbox.dev/documentation/getting-started/mcp_quickstart (fetched 2026-08-29T08:02:49.282647+00:00, sha 9673f7f377e1)
  - site_page: https://mcp-toolbox.dev/documentation/getting-started/local_quickstart (fetched 2026-08-29T08:02:49.284368+00:00, sha 966d4ab92d87)
  - site_page: https://mcp-toolbox.dev/documentation/getting-started/local_quickstart_js (fetched 2026-08-29T08:02:49.286672+00:00, sha bd77ab256a38)
  - site_page: https://mcp-toolbox.dev/documentation/getting-started/local_quickstart_go (fetched 2026-08-29T08:02:49.288961+00:00, sha 9714bcc273e5)
  - site_page: https://mcp-toolbox.dev/documentation/configuration (fetched 2026-08-29T08:02:49.291575+00:00, sha eb43123ae29e)
  - site_page: https://mcp-toolbox.dev/documentation/configuration/authentication (fetched 2026-08-29T08:02:49.293733+00:00, sha 78c77b02a0f4)
- Data as of 2026-08-30T08:39:29.467469+00:00.