\n\n```bash\n +------------------+ +--------------+ +------------------+\n | | | | | |\n | | | | | |\n | Claude Desktop +--->+ +--->+ PostgreSQL |\n | | | | | |\n | Claude Code +--->+ +--->+ SQL Server |\n | | | | | |\n | Cursor +--->+ DBHub +--->+ SQLite |\n | | | | | |\n | VS Code +--->+ +--->+ MySQL |\n | | | | | |\n | Copilot CLI +--->+ +--->+ MariaDB |\n | | | | | |\n | | | | | |\n +------------------+ +--------------+ +------------------+\n MCP Clients MCP Server Databases\n```\n\nDBHub is a zero-dependency, token efficient MCP server implementing the Model Context Protocol (MCP) server interface. This lightweight gateway allows MCP-compatible clients to connect to and explore different databases:\n\n- **Local Development First**: Zero dependency, token efficient with just two MCP tools to maximize context window\n- **Multi-Database**: PostgreSQL, MySQL, MariaDB, SQL Server, and SQLite through a single interface\n- **Multi-Connection**: Connect to multiple databases simultaneously with TOML configuration\n- **Guardrails**: Read-only mode, row limiting, and query timeout to prevent runaway operations\n- **Secure Access**: SSH tunneling and SSL/TLS encryption\n\n## Supported Databases\n\nPostgreSQL, MySQL, SQL Server, MariaDB, and SQLite.\n\n## MCP Tools\n\nDBHub implements MCP tools for database operations:\n\n- **[execute_sql](https://dbhub.ai/tools/execute-sql)**: Execute SQL queries with transaction support and safety controls\n- **[search_objects](https://dbhub.ai/tools/search-objects)**: Search and explore database schemas, tables, columns, indexes, and procedures with progressive disclosure\n- **[Custom Tools](https://dbhub.ai/tools/custom-tools)**: Define reusable, parameterized SQL operations in your `dbhub.toml` configuration file\n\n## Workbench\n\nDBHub includes a [built-in web interface](https://dbhub.ai/workbench/overview) for interacting with your database tools. It provides a visual way to execute queries, run custom tools, and view request traces without requiring an MCP client.\n\n\n\n## Installation\n\nSee the full [Installation Guide](https://dbhub.ai/installation) for detailed instructions.\n\n### Quick Start\n\n**Docker:**\n\n```bash\ndocker run --rm --init \\\n --name dbhub \\\n --publish 8080:8080 \\\n bytebase/dbhub \\\n --transport http \\\n --port 8080 \\\n --dsn \"postgres://user:password@localhost:5432/dbname?sslmode=disable\"\n```\n\n**NPM:**\n\n```bash\nnpx @bytebase/dbhub@latest --transport http --port 8080 --dsn \"postgres://user:password@localhost:5432/dbname?sslmode=disable\"\n```\n\n**Demo Mode:**\n\n```bash\nnpx @bytebase/dbhub@latest --transport http --port 8080 --demo\n```\n\nSee [Command-Line Options](https://dbhub.ai/config/command-line) for all available parameters.\n\n### Multi-Database Setup\n\nConnect to multiple databases simultaneously using TOML configuration files. Perfect for managing production, staging, and development databases from a single DBHub instance.\n\nSee [Multi-Database Configuration](https://dbhub.ai/config/toml) for complete setup instructions.\n\n## Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Run in development mode\npnpm dev\n\n# Build and run for production\npnpm build && pnpm start --transport stdio --dsn \"postgres://user:password@localhost:5432/dbname\"\n```\n\nSee [Testing](.claude/skills/testing/SKILL.md) and [Debug](https://dbhub.ai/config/debug).\n\n## Contributors\n\n\n \n\n\n## Star History\n\n\n \n \n \n \n \n\n","readmeFilename":"README.md"}
![\"DBHub](\"https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-light.svg\"){kind=logo}
\n