DBX 轻量级跨平台数据库管理工具

项目地址：https://github.com/t8y2/dbx

一句话介绍：90+ 数据库，只需 20 MB。 提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

1. 项目概览

DBX 是一款用 Rust 编写的轻量级数据库客户端，定位是 DBeaver / Navicat / TablePlus 的开源轻量替代品。与 DBeaver 不同，它不需要 Java 运行时；与 TablePlus 不同，它是跨平台开源的。

2. 支持的数据库

官方称支持 90+ 种数据库，常见包括：

• 关系型数据库：MySQL、PostgreSQL、SQLite、MariaDB、SQL Server、Oracle、Access
• 国产数据库：达梦（DM）、OceanBase、openGauss、GaussDB、KingbaseES、Vastbase、GoldenDB、HighGo、UXDB、XuguDB、YashanDB、GBase 8a/8s、KWDB、TDengine
• 分析型/分布式：ClickHouse、DuckDB、TiDB、Doris、SelectDB、StarRocks、Redshift、CockroachDB、Dolt
• NoSQL / 键值：Redis、MongoDB、etcd、ZooKeeper、Nacos、Consul KV
• 搜索：Elasticsearch、Easysearch、Meilisearch、Manticore Search
• 向量数据库：Qdrant、Milvus、Weaviate
• 时序/IoT：InfluxDB、QuestDB、IoTDB、TDengine
• 云/其他：Cloudflare D1、Cloud Spanner、Snowflake、Trino、PrestoSQL、Hive、DB2、Informix、Neo4j、Cassandra、BigQuery、Kylin、Databricks、SAP HANA、Teradata、Vertica、Firebird、Exasol、Databend、RQLite、Turso
• 消息队列：Pulsar、Kafka、RocketMQ

此外可通过 JDBC Agent 驱动扩展更多连接（H2、Snowflake、Hive、DB2、BigQuery 及自定义 JDBC）。

3. 核心功能

3.1 SQL 编辑器

• 基于 CodeMirror 6，支持语法高亮、元数据感知自动补全
• Cmd+Enter 快捷执行、选中片段执行
• SQL 格式化、诊断提示、9 种编辑器主题
• 查询历史、SQL 片段保存、标签页恢复、直接执行 .sql 文件

3.2 数据表格（Data Grid）

• 虚拟滚动，可承载大结果集
• 表格内联编辑，保存前预览生成的 SQL
• WHERE / ORDER BY 控制、DataGrip 风格过滤器、LIKE 上下文过滤
• 排序、全文搜索、分页、列宽调整、斑马纹
• 导出/复制为 CSV、JSON、Markdown、XLSX、INSERT 语句

3.3 Schema 工具

• 库/表/列/索引/外键/触发器浏览，支持搜索与置顶
• 存储过程、函数、视图分组浏览，部分支持源码编辑
• 表结构编辑器（支持的引擎可审查列和索引变更）
• ER 图、Schema Diff（跨连接结构对比）、可视化执行计划、字段血缘分析

3.4 数据操作

• CSV / Excel 导入
• 跨库数据迁移（Data transfer）
• 整库导出、表数据对比
• 拖拽预览 Parquet / CSV / JSON（基于 DuckDB）
• 支持从 DBeaver、Navicat 导入连接配置

3.5 Redis / MongoDB 专用浏览器

• Redis：Key 模式搜索、批量操作、命令执行、TTL 编辑，支持 String/Hash/List/Set/ZSet/Stream 全部数据类型
• MongoDB：文档增删改查、分页，支持 Atlas 与副本集 URL 连接

3.6 连接与安全

• SSH 隧道（密钥/密码）、代理设置、断线自动重连
• 危险操作确认对话框、连接配置加密导出导入
• 连接颜色标记、驱动商店、可选 JDBC 插件
• 深色模式、英文/简体中文/西班牙语、内置自动更新

4. AI 能力

4.1 内置 AI SQL 助手

• 用自然语言描述需求即可生成 SQL
• 支持解释查询、优化 SQL、修复报错
• 执行前对 AI 生成的 SQL 做内置安全检查
• 支持 Claude、OpenAI、Ollama 本地模型及任意 OpenAI 兼容接口

4.2 MCP Server（让 AI 编程工具直连数据库）

DBX 提供独立的 Rust MCP Server，可复用 DBX 中已配置的连接，供 Claude Code、Cursor、Windsurf 等 MCP 客户端使用：

npx @dbx-app/mcp-server

.mcp.json 配置示例：

{
  "mcpServers": {
    "dbx": {
      "command": "npx",
      "args": ["-y", "@dbx-app/mcp-server"]
    }
  }
}

• 在 DBX Settings → MCP 中管理连接白名单与权限：read_only（只读）、safe_write（数据读写）、high_risk_write（完全访问）
• 提供 macOS/Linux/Windows 预编译原生二进制，离线/服务器环境无需 Node.js
• Web/Docker 部署时可通过 DBX_WEB_URL、DBX_WEB_PASSWORD 连接 Web 后端

4.3 CLI

npm install -g @dbx-app/cli
# 或 Homebrew
brew tap t8y2/tap && brew install dbx-cli

dbx connections list --json
dbx query local "select 1" --json

适合终端、脚本和 Codex 等工作流。

5. 安装

macOS

brew install --cask dbx

Windows（Scoop）

scoop bucket add dbx https://github.com/t8y2/scoop-bucket
scoop install dbx

Windows（WinGet）

winget install t8y2.dbx

Linux（Flatpak）

flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
flatpak install flatpark com.dbxio.dbx

也可以直接在 GitHub Releases 下载对应平台安装包。

6. Docker 自托管（Web 版）

docker run -d --pull=always --name dbx \
  -p 4224:4224 \
  -v dbx-data:/app/data \
  t8y2/dbx:latest

Docker Compose 示例：

services:
  dbx:
    image: t8y2/dbx:latest
    # 国内可改用：docker.cnb.cool/dbxio.com/dbx:latest
    pull_policy: always
    ports:
      - "4224:4224"
    volumes:
      - dbx-data:/app/data
    restart: unless-stopped

volumes:
  dbx-data:

启动后访问 http://localhost:4224。支持 amd64/arm64 多架构；反向代理子路径可通过 DBX_PUBLIC_BASE_PATH 设置。

7. 与 DBeaver 对比

8. 适用场景

• 需要一个轻量、无 Java 依赖的数据库客户端
• 同时管理 MySQL、PostgreSQL、Redis、MongoDB、ClickHouse、达梦等多种数据库
• 希望在数据库工具里直接使用 AI 生成/解释/优化 SQL
• 让 Cursor、Claude Code 等 AI 编程工具通过 MCP 访问数据库
• 通过 Docker 自建团队共享的 Web 数据库管理平台

9. 参考链接

• 官方文档：https://dbxio.com/en/docs/what-is-dbx
• GitHub Releases：https://github.com/t8y2/dbx/releases/latest
• MCP Server README：packages/mcp-server/README.md
• CLI README：packages/cli/README.md