bytebase/dbhub

DBHub – 一个轻量且 Token 高效的 MCP 服务器，用于 AI 驱动的数据库访问

它是什么 – DBHub 是一个轻量级的 Model-Connect-Protocol (MCP) 服务器，让 AI 驱动的工具（如 Claude Desktop/Code、Cursor、VS Code、Copilot CLI 等）能与真实的关联式数据库沟通。它以单一程序执行，无外部依赖，且仅公开 LLM 安全探索或查询数据所需的必要工具。

对 AI/ML 的重要性 – 现代基于 LLM 的代理需要一种无需耗尽模型 Context Window 即可执行 SQL 的方法。DBHub 的默认工具集（仅 execute_sql 与 search_objects）占用约 1.4k Token，比竞争的 MCP 服务器小 10 倍以上。这为模型的 Prompt 空间留下了更多余裕来进行实际的推理任务，使 DBHub 成为语言模型与生产数据库之间实用的桥梁。

主要功能

• Token 高效核心 – 2 个内置工具，仅 1.4k Token。
• 多数据库支持 – PostgreSQL、MySQL、MariaDB、SQL Server、Oracle、SQLite。
• 通过单一 TOML 文件进行多连接 – 为多个数据库执行一个 DBHub 程序。
• 安全防护机制 – 只读模式、行数限制、查询超时、SSH 通道、TLS 加密。
• 可选额外工具 – explain_sql、health_check 以及用户自定义工具。
• 内置网页工作台 – 可视化查询控制台与请求追踪查看器。
• 零运行时依赖 – 仅需 Node ≥ 22.5 (使用内置的 node:sqlite)。

典型使用案例

1. 本地开发 – 让 Claude Code 或 VS Code 在不离开编辑器的情况下探索结构、验证查询并除错数据。
2. 非技术仪表板 – 通过 AI 助理向业务用户公开只读、限流的视图。
3. 整合式数据库网关 – 用一个 DBHub 实例取代多个独立的 MCP 服务器。
4. 生产环境故障排除 – 当服务异常时，通过 LLM 执行安全的只读诊断。

如何开始

# 快速指令 (npm) – 在 8080 端口执行基于 HTTP 的 MCP 服务器
npx @bytebase/dbhub@latest \
  --transport http \
  --port 8080 \
  --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

其他部署选项：

• Docker 镜像 (从 Docker Hub 拉取)
• MCP Bundle (一键式、只读模式)
• Claude Code 插件 (直接整合于 Claude UI)

开发工作流程

pnpm install          # 安装开发依赖
pnpm dev              # 执行热重载
pnpm build && pnpm start --transport stdio --dsn "postgres://…"

仓库包含用于多数据库配置的 dbhub.toml、位于 /docs/images/workbench 的网页工作台，以及测试/除错文档。

幕后团队 – 该项目由 Bytebase 维护（企业级数据库 MCP 平台的幕后公司）。README 指向完整的 Bytebase 产品，供需要更丰富防护机制的团队使用。

---

所有细节均直接取自仓库的 README；未推断任何额外功能。