DBHub is a zero-dependency MCP server developed by Bytebase that enables AI agents and language models to interact with multiple database systems through a standardized interface. Written in TypeScript, it implements the Model Context Protocol to allow MCP-compatible clients such as Claude, Cursor, and Dify to connect to and explore PostgreSQL, MySQL, SQL Server, MariaDB, and SQLite databases. The project is designed with token efficiency as a core principle, implementing just two primary MCP tools to maximize context window usage in AI applications.
The server provides two main database interaction tools: execute_sql for running SQL queries with transaction support and safety controls, and search_objects for exploring database schemas, tables, columns, indexes, and procedures through progressive disclosure. Additionally, users can define custom tools as reusable, parameterized SQL operations within a dbhub.toml configuration file. A built-in web workbench provides a visual interface for executing queries, running custom tools, and viewing request traces without requiring a separate MCP client.
DBHub prioritizes security and operational safety through several built-in guardrails. It supports read-only mode to prevent accidental modifications, implements row limiting to prevent excessive data retrieval, and enforces query timeouts to stop runaway operations. The server supports SSH tunneling and SSL/TLS encryption for secure database connections. The HTTP transport includes DNS-rebinding protection and defaults to loopback binding in production environments, with configurable allowed hosts to work behind reverse proxies.
The installation process is straightforward, supporting Docker deployment, NPM installation for Node.js 22.5.0 and above, and a demo mode for quick evaluation. Multi-database configuration allows simultaneous connections to multiple databases through TOML configuration files, making it suitable for managing production, staging, and development environments from a single DBHub instance. The project requires Node.js 22.5.0 or later due to its use of the built-in node:sqlite module.
The repository shares contributors with notable projects including zitadel/zitadel, microsoft/vscode, and typeorm/typeorm, suggesting integration with broader development ecosystems.
