t8y2/dbx · 上手攻略

仓库：t8y2/dbx
链接：https://github.com/t8y2/dbx
分类：开发者工具 · 数据库 · MCP · CLI
作者：Jay
更新：2026-08-25

这是什么

DBX 是一个超轻量（~20 MB）的跨平台数据库客户端，支持 90+ 数据库，包括 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、ClickHouse、SQL Server、Elasticsearch、TiDB、OceanBase、GaussDB、Doris、StarRocks 等。零运行时依赖（无 Java、无 Python、无捆绑 Chromium），下载即用。支持桌面 GUI、CLI、Web 版（Docker 部署）和 MCP Server——让 AI 编程助手（Claude Code、Cursor、Windsurf 等）能够直接查询数据库。

解决什么问题

传统数据库客户端各有痛点：DBeaver 需要 Java 环境，TablePlus 只有 macOS，DataGrip 厚重且昂贵。大多数工具不支持 AI 集成，AI 写 SQL 时只能靠猜测或复制粘贴到客户端执行，效率低下且无法验证。

DBX 同时解决了两个问题：一是极简安装（单文件、零依赖），二是 AI 原生集成——内置 AI 助手可以直接解释、生成、优化 SQL，内置 MCP Server 让 AI Agent 能够自主连接数据库、浏览表结构、执行查询。

快速安装

桌面应用（推荐日常使用）

平台	安装方式
macOS	`brew install --cask dbx`
Windows	`winget install t8y2.dbx` 或 Scoop：`scoop bucket add dbx https://github.com/t8y2/scoop-bucket && scoop install dbx`
Linux	Flatpak：`flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo && flatpak install flatpark com.dbxio.dbx`
各平台通用	直接下载 Releases 最新版（.zip/.tar.gz）

Docker Web 版

docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx:latest
# 访问 http://localhost:4224

MCP Server（AI Agent 使用）

# 通过 npx（推荐）
npx -y @dbx-app/mcp-server

# 或全局安装 CLI 后使用独立 MCP 二进制
npm install -g @dbx-app/cli
# 独立 MCP 二进制：https://github.com/t8y2/dbx/releases?q=packages-v

MCP Server 配置（.mcp.json）：

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

Docker/Web 部署场景的 MCP 配置：

{
  "mcpServers": {
    "dbx": {
      "command": "npx",
      "args": ["-y", "@dbx-app/mcp-server"],
      "env": {
        "DBX_WEB_URL": "http://localhost:4224",
        "DBX_WEB_PASSWORD": "your-web-login-password"
      }
    }
  }
}

核心用法

桌面应用日常操作

连接数据库：首次启动后点击"新建连接"，填写主机/端口/用户名/密码，支持 SSH 隧道
AI 生成 SQL：在 SQL 编辑器中用自然语言描述需求，AI 自动生成 SQL，AI 生成的 SQL 会经过内置安全检查后才可执行
浏览数据：点击表名打开数据视图，支持虚拟滚动（大数据量不卡）、内联编辑、WHERE/ORDER BY 过滤
导出数据：支持 CSV、JSON、Markdown、XLSX、INSERT 语句多种格式

CLI 工具

# 列出所有连接
dbx connections list --json

# 执行查询
dbx query local "SELECT 1" --json

# 连接管理
dbx connections add --type mysql --host localhost --port 3306 --user root

MCP Server 工具（供 AI Agent 使用）

工具	说明
`dbx_list_connections`	列出所有配置的数据库连接
`dbx_list_tables`	列出连接中的所有表
`dbx_query`	执行任意 SQL 查询
`dbx_open_table`	在 DBX GUI 中直接打开指定表

数据库支持速查

完整支持原生驱动（无需额外配置）：MySQL、PostgreSQL、SQLite、Redis、MongoDB、TiDB、OceanBase、ClickHouse、SQL Server、Oracle、Elasticsearch、Meilisearch、Qdrant、Milvus、Weaviate、MariaDB、GaussDB、DuckDB、Doris、StarRocks、Redshift 等 90+ 种。

通过 Agent 扩展驱动（需要额外插件/配置）：Snowflake、BigQuery、Trino、Presto、Hive、DB2、Cassandra、Neo4j、SAP HANA、Teradata、Vertica、Databricks 等。

消息队列管理：Pulsar、Kafka、RocketMQ。

⚠️ MCP 只读/写权限分离：在 DBX Settings → MCP 中可设置连接的白名单和权限模式（只读、安全写、高风险写）。DBX_MCP_ALLOW_WRITES=0 环境变量在首次保存中央 MCP 策略前保持只读限制，之后由 DBX 内的策略接管。

典型适用场景

AI 编程助手查询生产数据库：Claude Code/Cursor 通过 MCP Server 直接连接数据库验证 AI 生成的迁移脚本，无需开发者手动执行
跨数据库迁移：Doris → StarRocks 的数据对比和迁移，用 DBX 的 Data Transfer 功能一站式完成
轻量级数据库管理：替代 DBeaver，不需要安装 Java，随时打开即用
团队数据库浏览器：通过 Docker 部署 Web 版，团队成员在浏览器中连接查看数据，无需安装客户端
AI SQL 审查：AI 生成的 SQL 经过 DBX 内置安全检查（权限范围、危险操作）后才执行，降低生产事故风险

坑与注意

⚠️ 无捆绑数据库驱动：DBX 本身约 20 MB，但各数据库驱动需要从 DBX 内置的驱动商店下载，首次连接某种数据库时会提示下载对应驱动。

⚠️ Windows 便携版 MCP 配置：Windows 便携版需要设置 DBX_DATA_DIR 环境变量，指向 DBX.exe 同目录下的数据文件夹（含 dbx.db），否则 MCP Server 无法正确连接。

⚠️ Web 版密码：Docker 部署时如果 Web 登录有密码，需要设置 DBX_WEB_PASSWORD 环境变量与登录密码一致。

⚠️ Agent 驱动是实验性功能：Snowflake、BigQuery 等 Agent 扩展驱动的连接稳定性取决于网络和驱动质量，生产环境建议使用原生支持。

⚠️ 只读模式很重要：AI 通过 MCP 查询数据库时务必开启只读模式（DBX Settings → MCP），防止 AI 执行 DROP TABLE 等高危操作。

⚠️ v0.5.93（2026-08-24）最新：包含 JDBC 手动事务、MySQL 事件管理、字段批量操作等大量新功能，建议保持更新。

与同类对比

工具	大小	跨平台	数据库数	AI/MCP 集成	依赖
DBX	~20 MB	Win/macOS/Linux/Web	90+	✅ 内置 MCP Server + AI 对话	零依赖
DBeaver	~200 MB	Win/macOS/Linux	80+	❌	需要 Java 17+
TablePlus	~30 MB	Win/macOS/Linux	主要数据库	❌	无，但仅 macOS 最优
DataGrip	~500 MB	Win/macOS/Linux	所有主流	❌	需要 Java
Adminer	~数 MB	任何 PHP 环境	MySQL/PostgreSQL 等	❌	需要 PHP
Beekeeper Studio	~100 MB	Win/macOS/Linux	主要数据库	❌	Electron（捆绑 Chromium）

核心优势：唯一同时做到"零依赖轻量 + 90+ 数据库 + AI MCP 原生集成"的工具，20 MB 对比 DBeaver 的 200 MB 和 DataGrip 的 500 MB，优势明显。

一句话推荐结论

需要管理多数据库、又希望 AI 编程助手能够直接操作数据库？DBX 以 20 MB 的体积提供了 90+ 数据库支持、内置 AI SQL 对话和 MCP Server，是目前最轻量的全能方案，v0.5.93 刚发布，工具链已相当成熟。