Skip to content
Back to search

dbhub

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bytebase--dbhub/badge.svg)](/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
  1. {
  2. "name": "dbhub",
  3. "owner": {
  4. "name": "Bytebase",
  5. "url": "https://www.bytebase.com"
  6. },
  7. "metadata": {
  8. "description": "Official DBHub plugin marketplace — install the DBHub database MCP server with setup and schema-exploration skills"
  9. },
  10. "plugins": [
  11. {
  12. "name": "dbhub",
  13. "source": "./plugin",
  14. "description": "Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, and SQLite, with skills for connection setup and schema exploration"
  15. }
  16. ]
  17. }
README.md · README · 152 lines
  1. > [!NOTE]
  2. > 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/).
  3. <p align="center">
  4. <a href="https://www.star-history.com/bytebase/dbhub">
  5. <picture>
  6. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/badge?repo=bytebase/dbhub&type=trending&theme=dark" />
  7. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/badge?repo=bytebase/dbhub&type=trending" />
  8. <img alt="GitHub Trending Repository of the Day" src="https://api.star-history.com/badge?repo=bytebase/dbhub&type=trending" />
  9. </picture>
  10. </a>
  11. </p>
  12. <p align="center">
  13. <a href="https://dbhub.ai/" target="_blank">
  14. <picture>
  15. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-dark.svg" width="75%">
  16. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-light.svg" width="75%">
  17. <img src="https://raw.githubusercontent.com/bytebase/dbhub/main/docs/images/logo/full-light.svg" width="75%" alt="DBHub Logo">
  18. </picture>
  19. </a>
  20. </p>
  21. ```bash
  22. +------------------+ +--------------+ +------------------+
  23. | | | | | |
  24. | Claude Desktop +--->+ +--->+ PostgreSQL |
  25. | | | | | |
  26. | Claude Code +--->+ +--->+ SQL Server |
  27. | | | | | |
  28. | Codex +--->+ DBHub +--->+ Oracle |
  29. | | | | | |
  30. | Cursor +--->+ +--->+ SQLite |
  31. | | | | | |
  32. | VS Code +--->+ +--->+ MySQL |
  33. | | | | | |
  34. | Copilot CLI +--->+ +--->+ MariaDB |
  35. | | | | | |
  36. +------------------+ +--------------+ +------------------+
  37. MCP Clients MCP Server Databases
  38. ```
  39. 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:
  40. - **Minimal**: Zero dependency, token efficient with a minimal set of MCP tools to maximize context window
  41. - **Multi-Database**: PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, and SQLite through a single interface
  42. - **Multi-Connection**: Connect to multiple databases simultaneously with TOML configuration
  43. - **Guardrails**: Read-only mode, row limiting, and query timeout to prevent runaway operations
  44. - **Secure Access**: SSH tunneling and SSL/TLS encryption
  45. > 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.
  46. ## Token Efficiency
  47. 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.
  48. | MCP Server | Default Config | Default Tools |
  49. |------------|---------------|--------------|
  50. | **DBHub** | **0.5k** | 2 (`execute_sql`, `search_objects`) |
  51. | MCP Toolbox | 7.7k | 29 |
  52. | Supabase MCP | 11.6k | 36 |
  53. ## Use Cases
  54. - **Local Development**: Schema exploration, query validation, and data debugging with Claude Code, VS Code, Cursor, etc.
  55. - **Non-Technical Access**: Expose curated, read-only views to non-technical staff via Claude Desktop, VS Code, Cursor, etc.
  56. - **Multi-Database Consolidation**: Replace separate MCP servers for each database with a single DBHub process
  57. - **Production Troubleshooting**: Read-only diagnostics with guardrails against runaway queries
  58. > 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).
  59. ## Supported Databases
  60. PostgreSQL, MySQL, SQL Server, MariaDB, Oracle, and SQLite.
  61. ## MCP Tools
  62. DBHub implements MCP tools for database operations:
  63. - **[execute_sql](https://dbhub.ai/tools/execute-sql)**: Execute SQL queries with transaction support and safety controls
  64. - **[search_objects](https://dbhub.ai/tools/search-objects)**: Search and explore database schemas, tables, columns, indexes, and procedures with progressive disclosure
  65. - **[explain_sql](https://dbhub.ai/tools/explain-sql)** (opt-in): Show a query's execution plan without running it
  66. - **[health_check](https://dbhub.ai/tools/health-check)** (opt-in): Report connection pool state and buffer cache hit ratio
  67. - **[Custom Tools](https://dbhub.ai/tools/custom-tools)**: Define reusable, parameterized SQL operations in your `dbhub.toml` configuration file
  68. ## Workbench
  69. 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.
  70. ![DBHub Workbench showing connection details and available tools](docs/images/workbench/workbench.webp)
  71. ## Installation
  72. ```bash
  73. npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
  74. ```
  75. For Claude Code, install the [plugin](https://dbhub.ai/claude-code-plugin):
  76. ```
  77. /plugin marketplace add bytebase/dbhub
  78. /plugin install dbhub@dbhub
  79. ```
  80. For Codex, install the [plugin](https://dbhub.ai/codex-plugin) (reads the connection string from `DBHUB_DSN`):
  81. ```bash
  82. codex plugin marketplace add bytebase/dbhub
  83. codex plugin add dbhub@dbhub
  84. ```
  85. Also available as:
  86. - [Docker image](https://dbhub.ai/installation#docker)
  87. - [MCP Bundle](https://dbhub.ai/mcpb) (one-click install, read-only)
  88. 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.
  89. ## Development
  90. Requires Node.js >= 22.5.0 (DBHub uses the built-in `node:sqlite` module).
  91. ```bash
  92. # Install dependencies
  93. pnpm install
  94. # Run in development mode
  95. pnpm dev
  96. # Build and run for production
  97. pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"
  98. ```
  99. See [Testing](.claude/skills/testing/SKILL.md) and [Debug](https://dbhub.ai/config/debug).
  100. See the [branding guide](BRANDING.md) for logo assets, the Zinc color theme, and the asset sync workflow.
  101. ## Contributors
  102. <a href="https://github.com/bytebase/dbhub/graphs/contributors">
  103. <img src="https://contrib.rocks/image?repo=bytebase/dbhub" />
  104. </a>
  105. ## Star History
  106. <a href="https://www.star-history.com/?repos=bytebase%2Fdbhub&type=date&legend=top-left">
  107. <picture>
  108. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=bytebase/dbhub&type=date&theme=dark&legend=top-left" />
  109. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=bytebase/dbhub&type=date&legend=top-left" />
  110. <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=bytebase/dbhub&type=date&legend=top-left" />
  111. </picture>
  112. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.