dbhub
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/bytebase--dbhub)HTML
<a href="/listings/bytebase--dbhub"><img src="/api/listings/bytebase--dbhub/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
For Claude Code, install the [plugin](https://dbhub.ai/claude-code-plugin):
/plugin marketplace add bytebase/dbhub /plugin install dbhub@dbhub
For Codex, install the [plugin](https://dbhub.ai/codex-plugin) (reads the connection string from `DBHUB_DSN`):
codex plugin marketplace add bytebase/dbhub codex plugin add dbhub@dbhub
Also available as:
- [Docker image](https://dbhub.ai/installation#docker) - [MCP Bundle](https://dbhub.ai/mcpb) (one-click install, read-only)
See the [Installation Guide](https://dbhub.ai/installation) for all options, [Command-Line Options](https://dbhub.ai/config/command-line) for parameters, and [Multi-Database Configuration](https://dbhub.ai/config/toml) for connecting several databases at once.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 17 lines
- {
- "name": "dbhub",
- "owner": {
- "name": "Bytebase",
- "url": "https://www.bytebase.com"
- },
- "metadata": {
- "description": "Official DBHub plugin marketplace — install the DBHub database MCP server with setup and schema-exploration skills"
- },
- "plugins": [
- {
- "name": "dbhub",
- "source": "./plugin",
- "description": "Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, and SQLite, with skills for connection setup and schema exploration"
- }
- ]
- }
README.md · README · 152 lines
- > [!NOTE]
- > If you need an enterprise-level database MCP server with built-in guardrails like approval flow, access control, data masking, and audit logging beyond what DBHub offers, check out [Bytebase](https://www.bytebase.com/).
- <p align="center">
- <a href="https://www.star-history.com/bytebase/dbhub">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=bytebase/dbhub&type=trending&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=bytebase/dbhub&type=trending" />
- <img alt="GitHub Trending Repository of the Day" src="https://api.star-history.com/badge?repo=bytebase/dbhub&type=trending" />
- </picture>
- </a>
- </p>
- <p align="center">
- <a href="https://dbhub.ai/" target="_blank">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-dark.svg" width="75%">
- <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-light.svg" width="75%">
- <img src="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-light.svg" width="75%" alt="DBHub Logo">
- </picture>
- </a>
- </p>
- ```bash
- +------------------+ +--------------+ +------------------+
- | | | | | |
- | Claude Desktop +--->+ +--->+ PostgreSQL |
- | | | | | |
- | Claude Code +--->+ +--->+ SQL Server |
- | | | | | |
- | Codex +--->+ DBHub +--->+ Oracle |
- | | | | | |
- | Cursor +--->+ +--->+ SQLite |
- | | | | | |
- | VS Code +--->+ +--->+ MySQL |
- | | | | | |
- | Copilot CLI +--->+ +--->+ MariaDB |
- | | | | | |
- +------------------+ +--------------+ +------------------+
- MCP Clients MCP Server Databases
- ```
- 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:
- - **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
- > DBHub is the official example in the [Claude Code docs](https://code.claude.com/docs/en/mcp#example-query-your-postgresql-database) 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.
- | MCP Server | Default Config | Default Tools |
- |------------|---------------|--------------|
- | **DBHub** | **0.5k** | 2 (`execute_sql`, `search_objects`) |
- | MCP Toolbox | 7.7k | 29 |
- | Supabase MCP | 11.6k | 36 |
- ## 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](https://dbhub.ai/config/read-only-mode).
- ## Supported Databases
- PostgreSQL, MySQL, SQL Server, MariaDB, Oracle, and SQLite.
- ## MCP Tools
- DBHub implements MCP tools for database operations:
- - **[execute_sql](https://dbhub.ai/tools/execute-sql)**: Execute SQL queries with transaction support and safety controls
- - **[search_objects](https://dbhub.ai/tools/search-objects)**: Search and explore database schemas, tables, columns, indexes, and procedures with progressive disclosure
- - **[explain_sql](https://dbhub.ai/tools/explain-sql)** (opt-in): Show a query's execution plan without running it
- - **[health_check](https://dbhub.ai/tools/health-check)** (opt-in): Report connection pool state and buffer cache hit ratio
- - **[Custom Tools](https://dbhub.ai/tools/custom-tools)**: Define reusable, parameterized SQL operations in your `dbhub.toml` configuration file
- ## Workbench
- DBHub 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.
- 
- ## Installation
- ```bash
- npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
- ```
- For Claude Code, install the [plugin](https://dbhub.ai/claude-code-plugin):
- ```
- /plugin marketplace add bytebase/dbhub
- /plugin install dbhub@dbhub
- ```
- For Codex, install the [plugin](https://dbhub.ai/codex-plugin) (reads the connection string from `DBHUB_DSN`):
- ```bash
- codex plugin marketplace add bytebase/dbhub
- codex plugin add dbhub@dbhub
- ```
- Also available as:
- - [Docker image](https://dbhub.ai/installation#docker)
- - [MCP Bundle](https://dbhub.ai/mcpb) (one-click install, read-only)
- See the [Installation Guide](https://dbhub.ai/installation) for all options, [Command-Line Options](https://dbhub.ai/config/command-line) for parameters, and [Multi-Database Configuration](https://dbhub.ai/config/toml) for connecting several databases at once.
- ## Development
- Requires Node.js >= 22.5.0 (DBHub uses the built-in `node:sqlite` module).
- ```bash
- # 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"
- ```
- See [Testing](.claude/skills/testing/SKILL.md) and [Debug](https://dbhub.ai/config/debug).
- See the [branding guide](BRANDING.md) for logo assets, the Zinc color theme, and the asset sync workflow.
- ## Contributors
- <a href="https://github.com/bytebase/dbhub/graphs/contributors">
- <img src="https://contrib.rocks/image?repo=bytebase/dbhub" />
- </a>
- ## Star History
- <a href="https://www.star-history.com/?repos=bytebase%2Fdbhub&type=date&legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=bytebase/dbhub&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=bytebase/dbhub&type=date&legend=top-left" />
- <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=bytebase/dbhub&type=date&legend=top-left" />
- </picture>
- </a>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.