DBHub is the official example in the Claude Code docs for connecting to PostgreSQL via MCP.
Token Efficiency
DBHub loads just 2 tools by default at 0.5k tokens — 16-25x fewer than alternatives — keeping the context window open for your actual work.Use Cases
- Local Development: Schema exploration, query validation, and data debugging with Claude Code, VS Code, Cursor, etc.
- Non-Technical Access: Expose curated, read-only views to non-technical staff via Claude Desktop, VS Code, Cursor, etc.
- Multi-Database Consolidation: Replace separate MCP servers for each database with a single DBHub process
- Production Troubleshooting: Read-only diagnostics with guardrails against runaway queries
Read-only mode is a guardrail, not a permission boundary. Always connect with a least-privilege, read-only database user. See Read-Only Mode.
Supported Databases
PostgreSQL, MySQL, SQL Server, MariaDB, Oracle, and SQLite.Why DBHub?
DBHub brings powerful database capabilities to AI coding assistants:- Minimal: Zero dependency, token efficient with a minimal set of MCP tools to maximize context window
- Multi-Database: PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, and SQLite through a single interface
- Multi-Connection: Connect to multiple databases simultaneously with TOML configuration
- Guardrails: Read-only mode, row limiting, and query timeout to prevent runaway operations
- Secure Access: SSH tunneling and SSL/TLS encryption
Key Features
MCP Tools
DBHub provides AI assistants with direct database access through these tools:- execute_sql: Run queries with transaction support and safety controls
- search_objects: Explore schemas, tables, columns, indexes, and procedures
- explain_sql (opt-in): Show a query’s execution plan without running it
- health_check (opt-in): Report connection pool state and buffer cache hit ratio
- Custom Tools: Define reusable, parameterized SQL operations
Workbench
A web-based interface for running database tools and viewing request traces without requiring an MCP client.Architecture
DBHub acts as a gateway between databases and AI agents. AI agents access databases through the/mcp endpoint using MCP tools, while the Workbench provides direct browser-based access for humans.
Getting Started
Installation
Install DBHub using Docker, NPM, the MCP Bundle, or the Claude Code and Codex plugins
Quickstart
Get DBHub running with your first database connection