Repolode
bytebase

bytebase/dbhub

一个精简、节省 token 的 MCP 服务器,让 AI 客户端查询和探索 PostgreSQL、MySQL 等多种数据库。

Star
3,689
Fork
341
未关闭 Issue
2
最近提交
7天前

这是什么?

DBHub 是一个 MCP(Model Context Protocol)服务器,让 Claude Desktop、Claude Code、Cursor、VS Code 等支持 MCP 的客户端通过统一入口连接多种 SQL 数据库。支持 PostgreSQL、MySQL、MariaDB、SQL Server、Oracle 和 SQLite,并可通过 TOML 配置同时连接多个数据库。

默认只提供 execute_sql 和 search_objects 两个工具,项目称其约占 1.4k token,为对话上下文留出更多空间。可选启用 explain_sql、health_check,也可以在 dbhub.toml 中定义参数化的自定义 SQL 工具。内置的网页工作台支持在不使用 MCP 客户端的情况下执行查询和工具。

安全方面提供只读模式、行数限制、查询超时、SSH 隧道和 SSL/TLS 加密。可通过 npx、Docker、MCP Bundle 或 Claude Code 插件运行,需要 Node.js 22.5 或更高版本。

核心功能

  • 01默认仅提供 execute_sql 和 search_objects 两个 MCP 工具,降低 token 占用。
  • 02通过同一接口支持 PostgreSQL、MySQL、MariaDB、SQL Server、Oracle 和 SQLite。
  • 03通过 TOML 配置同时连接多个数据库。
  • 04提供只读模式、行数限制和查询超时等防护措施。
  • 05支持 SSH 隧道和 SSL/TLS 加密连接。
  • 06内置网页工作台,可直接执行查询和自定义工具。

适用场景

  • 在本地开发时,通过 Claude Code、Cursor 或 VS Code 探索表结构并调试数据。
  • 让非技术人员通过 AI 客户端只读访问经过筛选的数据。
  • 用一个进程替代为每个数据库单独部署的多个 MCP 服务器。
  • 在生产环境进行只读诊断,并防止失控查询。

快速上手

  1. 1

    使用 npx 启动 DBHub,并指定数据库 DSN

    npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
  2. 2

    或者运行 Docker 镜像(参见 Docker 安装部分)

使用前须知

  • 开发构建需要 Node.js 22.5.0 或更高版本。

标签

常见问题

dbhub 是什么?
一个精简、节省 token 的 MCP 服务器,让 AI 客户端查询和探索 PostgreSQL、MySQL 等多种数据库。 DBHub 是一个 MCP(Model Context Protocol)服务器,让 Claude Desktop、Claude Code、Cursor、VS Code 等支持 MCP 的客户端通过统一入口连接多种 SQL 数据库。支持 PostgreSQL、MySQL、MariaDB、SQL Server、Oracle 和 SQLite,并可通过 TOML 配置同时连接多个数据库。
dbhub 可以免费使用吗?用的什么许可证?
dbhub 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
dbhub 还在维护吗?
活跃维护中。dbhub 最近一次提交是在 2026年10月13日。
dbhub 适合用来做什么?
在本地开发时,通过 Claude Code、Cursor 或 VS Code 探索表结构并调试数据。 让非技术人员通过 AI 客户端只读访问经过筛选的数据。 用一个进程替代为每个数据库单独部署的多个 MCP 服务器。 在生产环境进行只读诊断,并防止失控查询。
dbhub 怎么安装和运行?
使用 npx 启动 DBHub,并指定数据库 DSN: npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable" 或者运行 Docker 镜像(参见 Docker 安装部分)
在哪里获取 dbhub?
源代码和安装说明在 GitHub 上:https://github.com/bytebase/dbhub

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目