Skip to main content
DBHub DBHub DBHub is a minimal MCP server: token-efficient, zero-dependency, and just two tools by default with opt-in extras. This lightweight gateway allows MCP-compatible clients to connect to and explore different databases.
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