Data
Plugin
dbhub
Minimal database MCP server for Postgres, MySQL, SQL Server, MariaDB, SQLite.
Plugin Signal78/100Solid
maintained99
capable41
documented100
adopted75
Install on Claude Code
> /plugin marketplace add bytebase/dbhub> /plugin install dbhub@dbhub
Stats
3,314
Stars
285
Forks
Active
Maintenance
TypeScript
Language
MIT
License
1d ago
Last commit
1y ago
Created
Repo: bytebase/dbhub
What's inside
Skills
5/fix-bugUse when given a GitHub issue URL or number to investigate and implement a fix. Triggers on "fix issue", "fix bug", "fix #123", GitHub issue URLs, or any request to resolve a reported problem from a GitHub issue. Also triggers when asked to investigate errors, diagnose failures,/testingRun and troubleshoot tests for DBHub, including unit tests, integration tests with Testcontainers, and database-specific tests. Use when asked to run tests, fix test failures, debug integration tests, troubleshoot Docker/database container issues, or add new tests. Also use when/exploreExplore a database schema token-efficiently via the DBHub tools; use before writing SQL against a schema you haven't seen./setupConnect DBHub to a database or fix a failing connection; also covers changing the DSN, write access, or multiple databases./dbhubGuide for querying databases through DBHub MCP server. Use this skill whenever you need to explore database schemas, inspect tables, or run SQL queries via DBHub's MCP tools (search_objects, execute_sql, and the opt-in explain_sql and health_check). Activates on any database
MCP
1README
1[!NOTE]
Brought to you by Bytebase, open-source database governance platform.
+------------------+ +--------------+ +------------------+
| | | | | |
| | | | | |
| Claude Desktop +--->+ +--->+ PostgreSQL |
| | | | | |
| Claude Code +--->+ +--->+ SQL Server |
| | | | | |
| Cursor +--->+ DBHub +--->+ 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, 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 for connecting to PostgreSQL via MCP.
Token Efficiency
DBHub loads just 2 tools by default at 1.4k tokens — 13-14x fewer than alternatives — keeping the context window open for your actual work.
| MCP Server | Default Config | Default Tools |
|---|---|---|
| DBHub | 1.4k | 2 (execute_sql, search_objects) |
| MCP Toolbox | 19.0k | 28 |
| Supabase MCP | 19.3k | all |
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
Supported Databases
PostgreSQL, MySQL, SQL Server, MariaDB, and SQLite.
MCP Tools
DBHub implements MCP tools for database operations:
- execute_sql: Execute SQL queries with transaction support and safety controls
- search_objects: Search and explore database schemas, tables, columns, indexes, and procedures with progressive disclosure
- 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 in your
dbhub.tomlconfiguration file
Workbench
DBHub includes a built-in web interface 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
npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
Also available as:
- Docker image
- MCP Bundle (one-click install, read-only)
- Claude Code plugin
See the Installation Guide for all options, Command-Line Options for parameters, and Multi-Database Configuration for connecting several databases at once.
Development
Requires Node.js >= 22.5.0 (DBHub uses the built-in node:sqlite module).
# 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"
Contributors
Star History
File tree
308bytebase/dbhubView on GitHub
.claude/
.claude-plugin/
marketplace.json
skills/
fix-bug/
SKILL.md
testing/
SKILL.md
.dockerignore
.env.example
.github/
CODEOWNERS
copilot-instructions.md
workflows/
check-broken-links.yml
docker-publish.yml
mcpb-release.yml
npm-publish.yml
run-tests.yml
.gitignore
.npmrc
.prettierrc.json
bun.lock
CLAUDE.md
dbhub.toml.example
demo/
employee-sqlite/
employee.sql
load_department.sql
load_dept_emp.sql
load_dept_manager.sql
load_employee.sql
load_salary1.sql
load_title.sql
Dockerfile
docs/
blog/
dbhub-1-0-0.mdx
how-dbhub-adopts-mcp-spec-2026-07-28.mdx
postgres-mcp-server-review-dbhub.mdx
postgres-mcp-server-review-mcp-toolbox.mdx
postgres-mcp-server-review-supabase-mcp.mdx
state-of-postgres-mcp-servers-2025.mdx
claude-code-plugin.mdx
config/
command-line.mdx
debug.mdx
toml.mdx
docs.json
favicon.svg
images/
blog/
dbhub-1-0-0/
claude-code-docs-dbhub.webp
postgres-mcp-server-review-mcp-toolbox/
mcp-toolbox-console.webp
postgres-mcp-server-review-supabase-mcp/
supabase-oauth.webp
state-of-postgres-mcp-servers-2025/
mcp-vs-postgres.webp
claude-desktop.webp
cursor.webp
logo/
full-dark.svg
full-light.svg
icon.svg
text-dark.svg
text-light.svg
mcp-inspector.webp
workbench/
custom-tool.webp
execute-sql.webp
request-trace.webp
workbench.webp
index.mdx
installation.mdx
mcpb.mdx
quickstart.mdx
README.md
tools/
custom-tools.mdx
execute-sql.mdx
explain-sql.mdx
health-check.mdx
overview.mdx
search-objects.mdx
workbench/
overview.mdx
request-trace.mdx
tool-execution.mdx
frontend/
bun.lock
components.json
index.html
package.json
public/
favicon.svg
logo-full-light.svg
src/
api/
errors.ts
requests.ts
sources.ts
tools.ts
App.tsx
assets/
logos/
mariadb.svg
mysql.svg
postgres.svg
sqlite.svg
sqlserver.svg
components/
ErrorBoundary.tsx
Gutter/
Gutter.tsx
GutterIcon.tsx
GutterSourceItem.tsx
index.ts
icons/
ActivityIcon.tsx
CheckIcon.tsx
CopyIcon.tsx
HelpIcon.tsx
LockIcon.tsx
XIcon.tsx
Layout.tsx
Sidebar/
Logo.tsx
Sidebar.tsx
SourceList.tsx
tool/
index.ts
ParameterForm.tsx
ResultsTable.tsx
ResultsTabs.tsx
RunButton.tsx
SqlEditor.tsx
types.ts
ui/
accordion.tsx
alert-dialog.tsx
alert.tsx
autocomplete.tsx
avatar.tsx
badge.tsx
breadcrumb.tsx
button.tsx
card.tsx
checkbox-group.tsx
checkbox.tsx
collapsible.tsx
combobox.tsx
command.tsx
dialog.tsx
empty.tsx
field.tsx
fieldset.tsx
form.tsx
frame.tsx
group.tsx
input-group.tsx
input.tsx
kbd.tsx
label.tsx
menu.tsx
meter.tsx
number-field.tsx
pagination.tsx
popover.tsx
preview-card.tsx
progress.tsx
radio-group.tsx
scroll-area.tsx
select.tsx
separator.tsx
sheet.tsx
sidebar.tsx
skeleton.tsx
slider.tsx
spinner.tsx
switch.tsx
table.tsx
tabs.tsx
textarea.tsx
toast.tsx
toggle-group.tsx
toggle.tsx
toolbar.tsx
tooltip.tsx
views/
HomeRedirect.tsx
NotFoundView.tsx
RequestView.tsx
SourceDetailView.tsx
ToolDetailView.tsx
hooks/
use-mobile.ts
index.css
lib/
db-logos.ts
utils.ts
main.tsx
types/
datasource.ts
request.ts
vite-env.d.ts
tsconfig.json
vite.config.ts
LICENSE
mcpb/
dbhub.toml
icon.png
manifest.json
package.json
plugin/
.claude-plugin/
plugin.json
.mcp.json
dbhub.toml
README.md
skills/
explore/
SKILL.md
setup/
SKILL.md
pnpm-lock.yaml
pnpm-workspace.yaml
README.md
scripts/
build-mcpb.mjs
mcpb-common.mjs
smoke-test-build.mjs
smoke-test-mcpb.mjs
sync-version.mjs
server.json
skills/
dbhub/
SKILL.md
src/
__fixtures__/
helpers.ts
toml/
multi-sqlite.toml
readonly-maxrows.toml
__tests__/
http-bind-host.integration.test.ts
json-rpc-integration.test.ts
load-connectors.test.ts
plugin-consistency.test.ts
api/
__tests__/
requests.integration.test.ts
sources.integration.test.ts
openapi.d.ts
openapi.yaml
requests.ts
sources.ts
config/
__tests__/
env.test.ts
ssh-config-integration.test.ts
toml-loader.test.ts
demo-loader.ts
env.ts
toml-loader.ts
connectors/
__tests__/
connect-failure-cleanup.test.ts
dsn-parser.test.ts
manager.test.ts
mariadb.integration.test.ts
multi-sqlite-sources.integration.test.ts
mysql.integration.test.ts
postgres-ssh.integration.test.ts
postgres.integration.test.ts
procedure-identifier-quoting.test.ts
readonly-transaction-strategy.test.ts
shared/
integration-test-base.ts
sqlite.integration.test.ts
sqlserver.integration.test.ts
health-check-utils.ts
interface.ts
manager.ts
mariadb/
index.ts
mysql/
mysql-family-health-check.ts
index.ts
postgres/
failed-to-read-certificate.ts
index.ts
sqlite/
index.ts
suppress-experimental-warning.ts
sqlserver/
index.ts
index.ts
requests/
__tests__/
store.test.ts
index.ts
store.ts
server.ts
tools/
__tests__/
custom-tool-handler.test.ts
execute-sql.test.ts
explain-sql.test.ts
health-check.test.ts
registry.test.ts
search-objects.test.ts
builtin-tools.ts
custom-tool-handler.ts
execute-sql.ts
explain-sql.ts
health-check.ts
index.ts
registry.ts
search-objects.ts
types/
config.ts
sql.ts
ssh.ts
utils/
__tests__/
allowed-keywords.test.ts
auth-token.test.ts
aws-rds-signer-missing.test.ts
aws-rds-signer.test.ts
bigint-handling.test.ts
config-watcher.test.ts
cross-origin.test.ts
dsn-obfuscate.test.ts
error-classifier.test.ts
identifier-quoter.test.ts
normalize-id.test.ts
parameter-mapper.test.ts
safe-url.test.ts
server-flavor.test.ts
sql-access-policy.test.ts
sql-parser.test.ts
sql-row-limiter.test.ts
ssh-config-parser.test.ts
ssh-tunnel.test.ts
tool-metadata.integration.test.ts
tool-metadata.test.ts
allowed-keywords.ts
auth-token.ts
aws-rds-signer.ts
client-identifier.ts
config-watcher.ts
cross-origin.ts
dsn-database.ts
dsn-obfuscate.ts
error-classifier.ts
identifier-quoter.ts
module-loader.ts
multi-statement-result-parser.ts
normalize-id.ts
parameter-mapper.ts
readonly-transaction.ts
resource-cleanup.ts
response-formatter.ts
safe-url.ts
server-flavor.ts
sql-access-policy.ts
sql-parser.ts
sql-row-limiter.ts
ssh-config-parser.ts
ssh-tunnel.ts
startup-table.ts
tool-handler-helpers.ts
tool-metadata.ts
tsconfig.json
tsup.config.ts
vitest.config.tsFAQ
dbhub is a Claude Code plugin with 5 hand-picked skills for data work, indexed on Flowy. Install it with the command on its page. It includes fix-bug, testing, explore. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is dbhub?
- Minimal database MCP server for Postgres, MySQL, SQL Server, MariaDB, SQLite.
- How do I install dbhub?
- Run these in Claude Code: /plugin marketplace add bytebase/dbhub then /plugin install dbhub@dbhub. Then prompt normally.
- Does dbhub auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is dbhub free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.