DBHub MCP server

Q: How do I add DBHub MCP to Claude Code?

Run `claude mcp add --env DB_PASSWORD= --env DSN= --env SSH_PASSPHRASE= --env SSH_PASSWORD= dbhub -- npx -y @bytebase/dbhub` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add DBHub MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

Commit Nov 12, 2026

bytebase/dbhub · typescript · MIT

Connects AI clients to PostgreSQL, MySQL, SQL Server, Oracle, MariaDB, and SQLite to explore schemas and execute SQL queries.

Also known as bytebase/dbhub, @bytebase/dbhub

stdio Databases Developer Tools DevOps & Infrastructure

Install GitHub ↗

Stars: 3,843
Tools: —
Downloads, 30 days: 176,231
Latest version: 1.6.1
Last commit: Nov 12, 2026
License: MIT

What is DBHub MCP?

DBHub is an MCP server. Connects AI clients to PostgreSQL, MySQL, SQL Server, Oracle, MariaDB, and SQLite to explore schemas and execute SQL queries.

Summary generated from the project's README

How to install DBHub MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env DB_PASSWORD=<YOUR_DB_PASSWORD> --env DSN=<YOUR_DSN> --env SSH_PASSPHRASE=<YOUR_SSH_PASSPHRASE> --env SSH_PASSWORD=<YOUR_SSH_PASSWORD> dbhub -- npx -y @bytebase/dbhub

~/.cursor/mcp.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "dbhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

~/.codex/config.toml

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

[mcp_servers.dbhub.env]
DB_PASSWORD = "<YOUR_DB_PASSWORD>"
DSN = "<YOUR_DSN>"
SSH_PASSPHRASE = "<YOUR_SSH_PASSPHRASE>"
SSH_PASSWORD = "<YOUR_SSH_PASSWORD>"

~/.gemini/settings.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

Set 17 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

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

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

Automated checks

Ran Nov 12, 2026Full report →

81/100

Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular package@bytebase/dbhub looks like dchub-mcp-serverFinding
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

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

            +------------------+    +--------------+    +------------------+
            |                  |    |              |    |                  |
            |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
            |                  |    |              |    |                  |
            |  Claude Code     +--->+              +--->+    SQL Server    |
            |                  |    |              |    |                  |
            |  Cursor          +--->+    DBHub     +--->+    Oracle        |
            |                  |    |              |    |                  |
            |  VS Code         +--->+              +--->+    SQLite        |
            |                  |    |              |    |                  |
            |  Copilot CLI     +--->+              +--->+    MySQL         |
            |                  |    |              |    |                  |
            |                  |    |              +--->+    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 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: 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.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.

workbench

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.

Contributors

Star History

Read full README

DBHub MCP questions

How do I add DBHub MCP to Claude Code?

Run claude mcp add --env DB_PASSWORD=<YOUR_DB_PASSWORD> --env DSN=<YOUR_DSN> --env SSH_PASSPHRASE=<YOUR_SSH_PASSPHRASE> --env SSH_PASSWORD=<YOUR_SSH_PASSWORD> dbhub -- npx -y @bytebase/dbhub in your terminal. Add --scope user to make it available in every project.

How do I add DBHub MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Which databases can DBHub connect to?

DBHub connects to PostgreSQL, MySQL, SQL Server, MariaDB, Oracle, and SQLite through a single interface.

What MCP tools does DBHub provide?

By default it loads two tools, execute_sql and search_objects, with opt-in explain_sql, health_check, and custom tools.

Can DBHub connect to multiple databases at once?

Yes, multi-connection is supported through TOML configuration.

Does DBHub have read-only safety controls?

Yes, it offers read-only mode, row limiting, and query timeouts to prevent runaway operations.

How do I run DBHub?

You can start it with npx using the HTTP transport, and it is also available as a Docker image, MCP Bundle, and Claude Code plugin.

Facts

Nov 13, 2026

Stars: 3,843
Downloads, 30 days: 176,231
Latest version: 1.6.1
Last commit: Nov 12, 2026
License: MIT
Transport: stdio
Package: @bytebase/dbhub

bytebase ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/bytebase/dbhub.svg)](https://hostedmcp.org/servers/bytebase/dbhub/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

DBHub MCP server

Commit Nov 12, 2026

bytebase/dbhub · typescript · MIT

Connects AI clients to PostgreSQL, MySQL, SQL Server, Oracle, MariaDB, and SQLite to explore schemas and execute SQL queries.

Also known as bytebase/dbhub, @bytebase/dbhub

stdio Databases Developer Tools DevOps & Infrastructure

Install GitHub ↗

Stars: 3,843
Tools: —
Downloads, 30 days: 176,231
Latest version: 1.6.1
Last commit: Nov 12, 2026
License: MIT

What is DBHub MCP?

DBHub is an MCP server. Connects AI clients to PostgreSQL, MySQL, SQL Server, Oracle, MariaDB, and SQLite to explore schemas and execute SQL queries.

Summary generated from the project's README

How to install DBHub MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env DB_PASSWORD=<YOUR_DB_PASSWORD> --env DSN=<YOUR_DSN> --env SSH_PASSPHRASE=<YOUR_SSH_PASSPHRASE> --env SSH_PASSWORD=<YOUR_SSH_PASSWORD> dbhub -- npx -y @bytebase/dbhub

~/.cursor/mcp.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "dbhub": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

~/.codex/config.toml

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

[mcp_servers.dbhub.env]
DB_PASSWORD = "<YOUR_DB_PASSWORD>"
DSN = "<YOUR_DSN>"
SSH_PASSPHRASE = "<YOUR_SSH_PASSPHRASE>"
SSH_PASSWORD = "<YOUR_SSH_PASSWORD>"

~/.gemini/settings.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub"
      ],
      "env": {
        "DB_PASSWORD": "<YOUR_DB_PASSWORD>",
        "DSN": "<YOUR_DSN>",
        "SSH_PASSPHRASE": "<YOUR_SSH_PASSPHRASE>",
        "SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
      }
    }
  }
}

Set 17 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

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

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

Automated checks

Ran Nov 12, 2026Full report →

81/100

Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular package@bytebase/dbhub looks like dchub-mcp-serverFinding
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

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

            +------------------+    +--------------+    +------------------+
            |                  |    |              |    |                  |
            |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
            |                  |    |              |    |                  |
            |  Claude Code     +--->+              +--->+    SQL Server    |
            |                  |    |              |    |                  |
            |  Cursor          +--->+    DBHub     +--->+    Oracle        |
            |                  |    |              |    |                  |
            |  VS Code         +--->+              +--->+    SQLite        |
            |                  |    |              |    |                  |
            |  Copilot CLI     +--->+              +--->+    MySQL         |
            |                  |    |              |    |                  |
            |                  |    |              +--->+    MariaDB       |
            |                  |    |              |    |                  |
            +------------------+    +--------------+    +------------------+
                 MCP Clients           MCP Server             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: 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.toml configuration file

Workbench

workbench

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.

Contributors

Star History

Read full README

DBHub MCP questions

How do I add DBHub MCP to Claude Code?

How do I add DBHub MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

Which databases can DBHub connect to?

DBHub connects to PostgreSQL, MySQL, SQL Server, MariaDB, Oracle, and SQLite through a single interface.

What MCP tools does DBHub provide?

By default it loads two tools, execute_sql and search_objects, with opt-in explain_sql, health_check, and custom tools.

Can DBHub connect to multiple databases at once?

Yes, multi-connection is supported through TOML configuration.

Does DBHub have read-only safety controls?

Yes, it offers read-only mode, row limiting, and query timeouts to prevent runaway operations.

How do I run DBHub?

You can start it with npx using the HTTP transport, and it is also available as a Docker image, MCP Bundle, and Claude Code plugin.

Facts

Nov 13, 2026

Stars: 3,843
Downloads, 30 days: 176,231
Latest version: 1.6.1
Last commit: Nov 12, 2026
License: MIT
Transport: stdio
Package: @bytebase/dbhub

bytebase ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/bytebase/dbhub.svg)](https://hostedmcp.org/servers/bytebase/dbhub/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

DBHub MCP server

What is DBHub MCP?

How to install DBHub MCP

Install DBHub MCP in Claude Code

Install DBHub MCP in Cursor

Install DBHub MCP in VS Code

Install DBHub MCP in Claude Desktop

Install DBHub MCP in Codex

Install DBHub MCP in Gemini CLI

Configuration

Automated checks

README

Token Efficiency

Use Cases

Supported Databases

MCP Tools

Workbench

Installation

Development

Contributors

Star History

DBHub MCP questions

DBHub MCP server

What is DBHub MCP?

How to install DBHub MCP

Install DBHub MCP in Claude Code

Install DBHub MCP in Cursor

Install DBHub MCP in VS Code

Install DBHub MCP in Claude Desktop

Install DBHub MCP in Codex

Install DBHub MCP in Gemini CLI

Configuration

Automated checks

README

Token Efficiency

Use Cases

Supported Databases

MCP Tools

Workbench

Installation

Development

Contributors

Star History

DBHub MCP questions