DBHub

Name: DBHub
Author: Bytebase

Lets an assistant explore schemas and run SQL on PostgreSQL, MySQL, MariaDB, SQL Server, Oracle and SQLite

By Bytebase TypeScript Local · stdio Databases

GitHub npm Website

86 popularity score ★ 3.8k ↓ 52k/wk

Connect your client

Local (npm)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

It needs DSN. Replace each <NAME> with your value.

Claude CodeTerminal

claude mcp add dbhub -e DSN=<DSN> -- npx -y @bytebase/dbhub

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<DSN>"
      }
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<DSN>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "dbhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DSN": "<DSN>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.dbhub]
command = "npx"
args = ["-y", "@bytebase/dbhub"]

[mcp_servers.dbhub.env]
DSN = "<DSN>"

Gemini CLITerminal

gemini mcp add --scope user -e DSN=<DSN> dbhub npx -- -y @bytebase/dbhub

Settings 5

`DSN`	Required: Database connection string, e.g. postgres://user:password@localhost:5432/dbname (or pass --dsn).
`TRANSPORT`	Optional: stdio (default) or http.
`PORT`	Optional: HTTP server port, http transport only (default 8080).
`DBHUB_AUTH_TOKEN`	Optional: Bearer tokens required on every HTTP request; auth is off unless set.
`DBHUB_HOST`	Optional: HTTP bind address (default 0.0.0.0).

What it does

DBHub is a database MCP server from Bytebase. One process connects an MCP client such as Claude Code, Claude Desktop, Cursor or VS Code to PostgreSQL, MySQL, MariaDB, SQL Server, Oracle or SQLite. It loads two tools by default, execute_sql and search_objects, to keep the tool list small. explain_sql and health_check are optional extras, and you can define your own parameterized SQL tools in a dbhub.toml file.

A single database is set with a DSN connection string, through the --dsn flag, the DSN variable or the DB_* variables. A TOML file passed with --config can connect several databases at once and set options per tool, such as read-only mode, row limits and query timeouts. Connections can go through SSH tunnels (bastion and jump hosts) and use SSL/TLS.

It runs on your machine with npx (Node.js 22.5.0 or later) or from the bytebase/dbhub Docker image, over stdio by default or over HTTP. HTTP mode also serves a web workbench for running queries and tools and viewing request traces. There is also a one-click MCP Bundle and a Claude Code plugin, and both are read-only.

Tools 4

execute_sql: Execute SQL queries with transaction support and safety controls
search_objects: Search and explore database schemas, tables, columns, indexes and procedures
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

Popularity

86 popularity score, on our list (the bar is 36)

★ 3.8k ↓ 52k/wk

GitHub stars, whole repository	3,804	37.7 points
Stars in 30 days	+189	10 points
npm downloads, last week	52,191	37.7 points

It lives in bytebase/dbhub, which holds more than this server. Its stars are the whole repository's, so in the score they never count for more than its own downloads.

Measured 2026-11-07. How the score works.

Where it is published

Code	bytebase/dbhub ★ 3.8k, the whole repository
npm	@bytebase/dbhub 1.6.0, 2026-11-07, the one the command runs
Docker Hub	bytebase/dbhub

What it can reach

Runs	On your machine
Reaches	A database, The internet
Changes things	Yes: it can write, send, create or delete
Sign-in	Other
Licence	MIT (npm)
Last code change	2026-11-07

Runs locally (npx or Docker) and connects to the databases you give it with your own credentials in a DSN or DB_* variables; SSH tunnel options can use SSH keys or an SSH agent. execute_sql runs any SQL, including INSERT, UPDATE, DELETE and DDL such as DROP TABLE, unless the tool is set to readonly = true in TOML; the docs say that mode is enforced by a keyword classifier and the database's own read-only mode. The MCP Bundle and Claude Code plugin are read-only. In HTTP mode it binds to 0.0.0.0 by default and bearer-token auth is off unless DBHUB_AUTH_TOKEN is set; the docs recommend binding to 127.0.0.1 for production.

Over time

GitHub stars, whole repository 3.8k +189 (+5 %)

3.8k3.6k

8 Oct 20267 Nov 2026

npm downloads a week 52k +46k (+742 %)

52k2.1k

20 Oct 20257 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 86 +6 (+7 %)

8667

8 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-13.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![DBHub on EveryMCPServer](https://everymcpserver.com/badge/dbhub.svg)](https://everymcpserver.com/servers/dbhub)

Connect your client

Add in one click

Or add it by command or config

Settings 5

What it does

Tools 4

Similar servers

MCP Toolbox for Databases

Busabase

OmniSQL MCP

dbt MCP Server

YugabyteDB MCP Server

Faucet