DBHub

官方

Bytebase 官方维护，极简双工具数据库 MCP Server

分类: 数据库第 3 / 58
Stars: ★ 3.7k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 22.5.0+ · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 8 天前
工具数: 2

74FMRS · B

Bytebase 官方维护，工具数量克制到只有两个，MCP Bundle 的只读默认设计对非技术用户友好。核心风险在于 execute_sql 默认可执行任意 SQL，需要用户主动搭配只读账户或护栏参数。评分基于源码与文档静态核验，未实际连接数据库测试。

最强项 · 安装易用性 17/20 最弱项 · 可靠性 13/20

可靠性

13/20

安全与权限

13/20

维护活跃度

16/20

文档质量

15/20

安装易用性

17/20

实测已过期收录于 2026-07-24

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

希望用最少工具数量、最省上下文窗口的方式接入数据库的场景
需要给非技术团队成员开放安全只读数据库访问权限的场景

不适合谁

需要执行数据库管理类操作（建索引、改 schema）而不只是查询的场景（DBHub 定位是查询而非 DBA 管理工具）

所需权限

需要数据库连接字符串（DSN），可能包含用户名密码等敏感信息
execute_sql 默认可执行任意 SQL（含写操作），需要通过只读模式或数据库账户权限主动限制

风险与副作用

默认配置下 execute_sql 若连接的数据库账户拥有写权限，AI 助手可能执行意外的写入或删除操作，生产环境建议搭配只读数据库账户
DSN 中包含明文密码，需注意配置文件的访问权限

安装接入

准备工作

运行环境：Node.js 22.5.0+ · Docker

DSN 可选密钥数据库连接字符串（如 postgres://user:pass@host:5432/db），由你自己的数据库提供。

DB_PASSWORD 可选密钥数据库密码，由你自己的数据库提供。

SSH_PASSWORD 可选密钥 SSH 密码，由你的 SSH 服务器提供。

SSH_PASSPHRASE 可选密钥 SSH 私钥口令。

其他可选配置项（12 个）

DB_TYPE 可选数据库类型：postgres、mysql、mariadb、sqlserver、oracle 或 sqlite。

DB_HOST 可选数据库主机名。

DB_PORT 可选数据库端口。

DB_USER 可选数据库用户名。

DB_NAME 可选数据库名称或 SQLite 文件路径。

TRANSPORT 可选传输模式：stdio 或 http。

PORT 可选 HTTP 服务器端口，默认 8080。

ID 可选实例标识符，用于工具命名。

SSH_HOST 可选 SSH 隧道服务器主机名。

SSH_PORT 可选 SSH 服务器端口，默认 22。

SSH_USER 可选 SSH 用户名。

SSH_KEY 可选 SSH 私钥文件路径。

1）NPM 直接运行：npx @bytebase/dbhub@latest --transport stdio --dsn "postgres://user:pass@host:5432/db"（Node.js ≥ 22.5.0）。
2）一键安装包：从 GitHub Release 下载 .mcpb 文件，拖入 Claude Desktop 等支持 MCPB 的客户端，本地 stdio 运行且默认只读，适合非技术团队成员使用。
3）Claude Code 用户可用官方插件一条命令注册，交互式录入连接串。

claude_desktop_config.json

{
  "mcpServers": {
    "dbhub": {
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--transport", "stdio"],
      "env": {
        "DSN": "postgres://user:password@localhost:5432/dbname?sslmode=disable"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "dbhub": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub",
        "--transport",
        "stdio"
      ],
      "env": {
        "DSN": "postgres://user:password@localhost:5432/dbname?sslmode=disable"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add dbhub -e 'DSN=postgres://user:password@localhost:5432/dbname?sslmode=disable' -- npx -y @bytebase/dbhub --transport stdio

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应能看到 execute_sql 和 search_objects 两个工具；可以让 AI 执行 search_objects 搜索表名，若返回了数据库表结构则说明连接成功。

常见排障

连接失败：检查 DSN 格式和 sslmode 参数是否匹配数据库实际配置
查询超时：确认是否命中了内置的查询超时护栏，可能是查询本身效率问题
MCP Bundle 无法安装：确认客户端支持 MCPB 格式（modelcontextprotocol/mcpb）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我的 PostgreSQL 数据库里的所有表
查看 users 表的列和索引结构
搜索数据库中与订单相关的表和存储过程
统计 orders 表有多少行记录

工具能力 2

execute_sql 写入

执行 SQL 查询，支持事务和安全控制

search_objects 只读

搜索和探索数据库 schema、表、列、索引和存储过程

使用场景

让 AI 助手直接查询业务数据库回答问题，无需手写 SQL

非技术同事通过只读 MCP Bundle 安全地查询数据库

探索陌生数据库的表结构、索引和字段

同时连接多个不同类型的数据库做统一查询入口

支持客户端

Claude Desktop

Claude Code

VS Code

Cursor

Zed

依据项目文档列出，未经本站实测。

详细介绍

由开源数据库 DevSecOps 平台 Bytebase 官方维护的 MCP Server，主打"零依赖、只用两个工具"的极简设计以节省上下文窗口：一个用于执行 SQL（带事务和安全控制），一个用于搜索探索数据库 schema。同时支持 PostgreSQL、MySQL、MariaDB、SQL Server、SQLite，可用 TOML 配置同时连接多个数据库，并提供只读模式、行数限制和查询超时等护栏。