DBHub

Name: DBHub
Author: bytebase

by bytebaseversion 1.6.0i★ 3,821iRuns on your computer

Registry nameio.github.bytebase/dbhub

Install

Overview

Description from the maker (original English)

Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi2 of 2 passedChecked from public information; code not scanned yet
UsageiWidely used↓ 58.4K/wk · ★ 3,821

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Databases & datasets
You need to fill in: DSN, DB_PASSWORD, SSH_PASSWORD, SSH_PASSPHRASE

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 2 of 2 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: DSN, DB_TYPE, DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME, TRANSPORT, PORT, ID, SSH_HOST, SSH_PORT, SSH_USER, SSH_PASSWORD, SSH_KEY, SSH_PASSPHRASE, SSH_AUTH_SOCK

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "your-value",
        "DB_TYPE": "your-value",
        "DB_HOST": "your-value",
        "DB_PORT": "your-value",
        "DB_USER": "your-value",
        "DB_PASSWORD": "your-value",
        "DB_NAME": "your-value",
        "TRANSPORT": "your-value",
        "PORT": "your-value",
        "ID": "your-value",
        "SSH_HOST": "your-value",
        "SSH_PORT": "your-value",
        "SSH_USER": "your-value",
        "SSH_PASSWORD": "your-value",
        "SSH_KEY": "your-value",
        "SSH_PASSPHRASE": "your-value",
        "SSH_AUTH_SOCK": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add dbhub --env DSN=your-value --env DB_TYPE=your-value --env DB_HOST=your-value --env DB_PORT=your-value --env DB_USER=your-value --env DB_PASSWORD=your-value --env DB_NAME=your-value --env TRANSPORT=your-value --env PORT=your-value --env ID=your-value --env SSH_HOST=your-value --env SSH_PORT=your-value --env SSH_USER=your-value --env SSH_PASSWORD=your-value --env SSH_KEY=your-value --env SSH_PASSPHRASE=your-value --env SSH_AUTH_SOCK=your-value -- npx -y @bytebase/dbhub

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "your-value",
        "DB_TYPE": "your-value",
        "DB_HOST": "your-value",
        "DB_PORT": "your-value",
        "DB_USER": "your-value",
        "DB_PASSWORD": "your-value",
        "DB_NAME": "your-value",
        "TRANSPORT": "your-value",
        "PORT": "your-value",
        "ID": "your-value",
        "SSH_HOST": "your-value",
        "SSH_PORT": "your-value",
        "SSH_USER": "your-value",
        "SSH_PASSWORD": "your-value",
        "SSH_KEY": "your-value",
        "SSH_PASSPHRASE": "your-value",
        "SSH_AUTH_SOCK": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "dbhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "your-value",
        "DB_TYPE": "your-value",
        "DB_HOST": "your-value",
        "DB_PORT": "your-value",
        "DB_USER": "your-value",
        "DB_PASSWORD": "your-value",
        "DB_NAME": "your-value",
        "TRANSPORT": "your-value",
        "PORT": "your-value",
        "ID": "your-value",
        "SSH_HOST": "your-value",
        "SSH_PORT": "your-value",
        "SSH_USER": "your-value",
        "SSH_PASSWORD": "your-value",
        "SSH_KEY": "your-value",
        "SSH_PASSPHRASE": "your-value",
        "SSH_AUTH_SOCK": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

DSN secret env
Database connection string (e.g., postgres://user:pass@host:5432/db)
DB_TYPE env
Database type: postgres, mysql, mariadb, sqlserver, oracle, sqlite
DB_HOST env
Database hostname
DB_PORT env
Database port
DB_USER env
Database username
DB_PASSWORD secret env
Database password
DB_NAME env
Database name or SQLite file path
TRANSPORT env
Transport mode: stdio or http
PORT env
HTTP server port (default: 8080)
ID env
Instance identifier for tool names
SSH_HOST env
SSH server hostname
SSH_PORT env
SSH server port (default: 22)
SSH_USER env
SSH username
SSH_PASSWORD secret env
SSH password
SSH_KEY env
Path to SSH private key
SSH_PASSPHRASE secret env
SSH key passphrase
SSH_AUTH_SOCK env
Path to SSH agent socket

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 10, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account bytebase, which owns the repo
✓ Pass
Still maintained
Code last changed today
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Databases & datasetsi

More stars than 100% of the other 1160 servers in this category
Published to the registry more recently than 91% of the other 1160 servers in this category
Basic checks equal to or better than 100% of the other 1160 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is DBHub safe?

It passed 2 of 2 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: DSN, DB_PASSWORD, SSH_PASSWORD, SSH_PASSPHRASE

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed today, and the latest version (1.6.0) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Dbx, MCP Toolbox for Databases, MCP Toolbox for Databases

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Dbx

Query databases from AI agents using connections configured in DBX.

by t8y2Widely used↓ 9.4K/wk★ 29.9KUpdated 6 months ago

Runs on your computer

Install

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

by googleapisWidely used★ 16.8KUpdated 5 days ago

Runs on your computer

Install

MCP Toolbox for Databases

MCP Toolbox for Databases enables your agent to connect to your database.

by googleapisWidely used★ 16.8KUpdated 8 months ago

Runs on your computer

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

[!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.

            +------------------+    +--------------+    +------------------+

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 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, 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 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"

See Testing and Debug.

DBHub

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Databases & datasetsi

Common questions

Alternatives

Dbx

MCP Toolbox for Databases

MCP Toolbox for Databases

README from the maker

Token Efficiency

Use Cases

Supported Databases

MCP Tools

Workbench

Installation

Development

Run in development mode

Build and run for production

Contributors

Star History