GitHub 上叫 “dbx” 的开源项目不止一个,本文重点讲那个 最值得装 的:rarnu/dbx——15MB、跨平台、原生 AI 辅助、支持 MCP 协议。
写在前面
打开 GitHub 搜 “dbx”,同名项目不止一个,对想找一个 ” 轻量级 AI 时代数据库客户端 ” 的人来说很痛苦——你不知道哪个才是你想要的。
本文重点讲当下 GitHub 上同名项目里 最活跃、最值得关注 的那个:rarnu/dbx。如果你只想看一个,那就看这个。
一、它解决什么问题
DBeaver 需要 Java。TablePlus 只在 macOS。DataGrip / Navicat 收费且重。pgAdmin / MySQL Workbench 是单数据库。
rarnu/dbx 的卖点就一句话:一个 15MB 的单二进制,跨 macOS/Windows/Linux,支持 30+ 数据库,原生 AI 辅助 + MCP 协议。
| 项 | 值 |
|---|---|
| 体积 | ~15 MB(无 JRE / 无 Python venv / 无 bundled Chromium) |
| 平台 | macOS / Windows / Linux 原生 + Docker 自托管 + Web 版 |
| 协议 | AGPL 3.0(注意:商用要开源) |
| GitHub | rarnu/dbx(1,343+ commits,活跃更新中) |
二、数据库支持范围(30+)
原生支持:MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Oracle、Elasticsearch、MariaDB、TiDB、OceanBase、openGauss、GaussDB、KWDB、KingBase、Vastbase、GoldenDB、Doris、SelectDB、StarRocks、Redshift、DM、TDengine、XuguDB、CockroachDB、Access、HighGo……
JDBC profiles 扩展 :H2、Snowflake、Trino、Hive、DB2、Informix、Neo4j、Cassandra、BigQuery、Kylin、SunDB,以及 自定义 JDBC。
三、AI 能力(这是真正区别于 DBeaver 的点)
1. 自然语言 → SQL
- 选中一张表 → 描述需求 → 拿到 SQL
- 支持 Claude / OpenAI / Ollama(本地模型)/ 任意 OpenAI 兼容端点
- 内置 SQL 安全检查(生成的 SQL 跑前会审一遍)
2. AI 解释 / 优化 / 修错 SQL
- 选中一段 SQL → 解释它在做什么
- 性能瓶颈分析
- 报错信息 → AI 自动修
3. 🔑 MCP(Model Context Protocol)原生支持
- 这是 rarnu/dbx 的 杀手锏
- Claude Code / Cursor / Windsurf 这些 AI 编程 agent,可以直接通过 MCP 调 DBX 查数据库
- “ 一次配置,处处可用 ”——你不用在每个 agent 里都重写数据库连接
四、编辑器 + 数据浏览
| 模块 | 能力 |
|---|---|
| SQL 编辑器 | CodeMirror 6,9 主题,Cmd+Enter 执行,元数据感知自动补全,SQL 格式化,Diagnostics |
| 结果表浏览 | 虚拟滚动(百万行不卡),内联编辑,DataGrip-style 过滤,LIKE / NOT LIKE 上下文过滤,全文搜索,分页,列宽自适应,斑马纹 |
| Schema 工具 | Schema browser、ER 图、Schema diff、Explain plan、字段血缘(column-level lineage)、数据库对象搜索 |
| 数据导入 / 导出 | CSV / Excel / JSON / Markdown / XLSX / INSERT 语句 |
| 协作 | 历史查询保存、SQL 片段库、tab 恢复、SQL 文件执行 |
五、对比:DBeaver / DataGrip / Navicat / TablePlus
| 维度 | rarnu/dbx | DBeaver | DataGrip | Navicat | TablePlus |
|---|---|---|---|---|---|
| 体积 | 15 MB | ~300 MB(JRE) | ~600 MB | ~200 MB | ~80 MB |
| 跨平台 | ✅ 全 | ✅ 全 | ✅ 全 | ✅ 全 | ❌ macOS only |
| 免费 | ✅ AGPL | ✅ | ❌ | ❌ | ⚠️ 限制 |
| AI 辅助 | ✅ 原生 | ⚠️ 插件 | ⚠️ 内置 | ❌ | ❌ |
| MCP 协议 | ✅ 原生 | ❌ | ❌ | ❌ | ❌ |
| 多数据库 | 30+ | 80+ | 20+ | 10+ | 10+ |
| 字段血缘 | ✅ | ❌ | ❌ | ❌ | ❌ |
| 商用风险 | ⚠️ AGPL 需开源 | ⚠️ | ❌ | ❌ | ❌ |
结论 :rarnu/dbx 是 ”AI 时代 ” 的最强 DB 客户端候选;体积小、AI 原生、MCP 是 独有的。
六、实战:rarnu/dbx + Claude Code 三步连
这是 rarnu/dbx 最性感的场景——让 Claude Code 直接查你的数据库。
步骤 1:装 DBX
去 GitHub Releases 下一个对应平台的二进制(~15MB),或者 docker run 起一个。
步骤 2:在 DBX 里配置数据库连接
打开 DBX,添加一个 MySQL / Postgres / 任何连接,存到一个命名 profile(比如 dev-local)。
步骤 3:配 Claude Code 的 MCP
在 Claude Code 的 MCP 配置里加:
{
"mcpServers": {
"dbx": {
"command": "dbx-mcp",
"args": ["--profile", "dev-local"]
}
}
}
之后在 Claude Code 里:
“ 看下我们 users 表今天新增了多少用户,写个 SQL”
Claude Code 会 直接调 DBX → DBX 调 MySQL → 返回结果 。 完全不用切窗口。
Cursor / Windsurf / 其他 MCP 兼容 agent 同理。
七、决策表:技术人应该选谁
| 你的场景 | 选谁 | 理由 |
|---|---|---|
| 想要一个 轻量、AI 原生、MCP 友好 的 DB 客户端 | rarnu/dbx | 三者全占 |
| 商业项目、不能接受 AGPL | DBeaver Community | Apache 2.0,比 dbx 体积大但无协议坑 |
| 想要 IDE 深度集成 | DataGrip | 钱能解决的事($229/ 年) |
| 已经在 macOS 上习惯 TablePlus | TablePlus | 习惯本身就是 ROI |
| 需要小众数据库(SAP HANA、Teradata、Firebird 等) | rarnu/dbx 的 JDBC 扩展或 DBeaver | dbx 通过 JDBC profile 可覆盖 |
实用主义建议 :先装 rarnu/dbx 试 1 周,看 AI/MCP 是不是真用得上;用不上就回 DBeaver, 别为了 ” 未来可能用得上 ” 投资两个工具。
八、风险与坑
- AGPL 3.0:如果你在公司项目里用,改了源码就要开源。这是协议硬约束,不算 ” 坑 ”,但很多人踩。
- AI 生成的 SQL 仍然要审 :DBX 有 ” 内置安全检查 ”,但 不是银弹 。生产环境执行前 必须自己审一遍。
- MCP 仍是新协议:生态在快速演化,兼容性可能变化。
- 多语言支持:DBX 官网是英文社区(dbxio.com),中文文档稀薄,遇到问题可能要直接读源码或 issue。
九、总结
rarnu/dbx 三个最值得装的理由:
- 15MB 跨平台单二进制——比 DBeaver 轻 20 倍
- 原生 AI 辅助——自然语言生成 SQL,AI 解释 / 修错
- MCP 原生——Claude Code / Cursor 直接连数据库
建议:装一周,看 MCP 是不是你的菜。是 → 留;不是 → 卸载,回 DBeaver。