DBHub is a minimal MCP server that connects to PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite via a single interface, with read-only guardrails and optional tools. It emphasizes token efficiency and multi-database connections, with a lightweight default toolset.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
DBHub is a minimal MCP server that provides token-efficient, zero-dependency routing to multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite) through a single interface. It supports multi-connection via TOML configuration and includes guardrails such as read-only mode, row limiting, and query timeout. It also offers secure access via SSH tunneling and SSL/TLS encryption. It is presented as the official example in Claude Code docs for connecting to PostgreSQL via MCP.
How it works
DBHub runs as an MCP server with a small default toolset and optional extras. It allows MCP-compatible clients to connect to and explore different databases through a lightweight gateway. The README outlines default tools (execute_sql, search_objects) and opt-in tools (explain_sql, health_check, custom tools), and notes that the server loads only a subset of tools by default to save tokens.
Getting started
Installation command:
npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
Development and build/run commands are provided:
# Install dependencies
pnpm install
# Run in development mode
pnpm dev
# Build and run for production
pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"
Additional installation options include a Docker image, MCP Bundle, and Claude Code plugin, with references to respective installation guides.
Recent releases
- v1.2.0 (2026-07-31): fix mysql server-side query timeout handling; fix SQL Server max_rows enforcement
- v1.1.0 (2026-07-31): block SELECT-invocable escape-hatch in readonly mode; add opt-in explain_sql tool
- v1.0.0 (2026-07-29): support EXPLAIN ANALYZE on SQL Server; stop logging SQL statements and parameters
- v0.24.0 (2026-07-20): fix TiDB support in readonly mode; close half-built connections on connect failure
- v0.23.0 (2026-07-10): full changelog available in repo
Traction
Stars: 3280 Forks: 280 Open issues: 1
Behind the repo
Not provided in the README snippet beyond the project’s branding and its association with Claude Code.
Caveats
License: MIT Created: 2025-03-09 Last push: 2026-08-03 Language: TypeScript