Dbx

官方

让 AI 智能体通过 DBX 已配置的连接查询和管理 70+ 种数据库

分类: 数据库第 25 / 58
Stars: ★ 28.9k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js · 预编译二进制
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 今天

57FMRS · C

DBX 是一个采用 Apache-2.0 许可、持续维护的开源项目，曾获 Trendshift、HelloGitHub、Product Hunt 等平台推荐。其 MCP Server 作为独立的 Rust 后端 npm 包发布，提供可配置的只读/读写/完全访问三级权限模式，但需要用户已预先在 DBX 中配置好数据库连接，且启用写权限时需自行评估数据安全风险。

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

14/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: manifest 声明了 stdio 传输和 npm 包 @dbx-app/mcp-server，README 给出了可运行的 npx 启动命令与 .mcp.json 配置示例，并说明 npm 安装本质上通过 Node 启动器调用同一个 Rust 二进制文件，具备一定合理性。但所提供材料中没有任何 CI 工作流或测试文件可验证初始化/工具列表握手的真实可复现性，也没有列出具体工具名称与参数 schema（仅笼统描述'listing connections, browsing tables, executing SQL'）。此外 MCP 服务器依赖 DBX 桌面/Web 端已配置好的连接才能工作，属于外部前置依赖，脆弱性增加；关于旧版 DBX_MCP_ALLOW_WRITES 环境变量与新版集中策略之间的兼容逻辑描述也显示出权限状态机较复杂，容易在升级路径上出错。按静态评审规则，没有可验证的 CI+测试证据，可靠性上限为 12 分，因证据薄弱进一步扣分。
安全与权限 10/20: 该服务器提供三档权限模式（read_only / safe_write / high_risk_write）并支持连接白名单，体现了最小权限设计意图，这是加分项。但材料中没有说明当 AI 代理通过 MCP 协议触发 high_risk_write 级别操作时是否存在协议层面的额外确认步骤（README 中提到的'confirmation dialogs for destructive operations'看起来更像面向桌面 UI 用户，而非 MCP 客户端调用路径）；Web/Docker 部署场景下 DBX_WEB_PASSWORD 以明文形式写入 MCP 配置文件（env 字段），存在凭据管理薄弱环节；'不收集遥测数据'属于自述声明，无法从提供材料中验证。这些因素叠加导致中等偏下的评分，但未达到红线级别（未发现明确的无确认破坏性默认行为、恶意代码或明文真实密钥）。
维护活跃度 14/20: 仓库使用 Apache-2.0 许可证，未被归档，版本号 0.4.55 显示出较高频率的迭代节奏，且拥有 Discord、QQ、微信等多个活跃社区渠道，并提及 CONTRIBUTING.md 贡献指南，显示出较强的维护意愿和治理基础。星标数高（13304）同时开放 issue 数量也较多（1149），未提供 issue 平均响应时间或近期提交记录等可验证证据；材料中也未见 SECURITY.md 或明确的安全响应渠道说明。综合评定为'活跃但部分治理信息缺失'的中高档水平。
文档质量 13/20: README 中的 MCP 章节内容较为详实，包含安装命令、mcp.json 配置示例、多种部署场景（本地、Windows 便携版、Web/Docker）下的环境变量说明（DBX_DATA_DIR、DBX_WEB_URL、DBX_WEB_PASSWORD、遗留的 DBX_MCP_ALLOW_WRITES）以及指向独立 MCP README 和示例目录的链接，具备分层文档的雏形。但本次评审材料中未包含 packages/mcp-server/README.md 的实际内容，因此无法验证其中是否列出了具体工具参数、调用限制、成本或故障排查指南；权限模式的说明也停留在概念层面，缺少操作示例。因此评为中等水平。
安装易用性 12/20: 官方给出的安装方式简单清晰：一条 npx 命令加上标准 .mcp.json 示例，并声明兼容 Claude Code、Cursor、Windsurf 等主流客户端，同时提供预编译原生二进制作为 Node.js 之外的备选方案，体现了较好的易用性设计。但实际使用前提是用户必须已经安装并配置好 DBX 桌面版或 Web 版及其数据库连接，这是一个未在 MCP 章节内详细展开的外部依赖步骤；Windows 便携版还需额外配置 DBX_DATA_DIR，Web/Docker 场景需额外设置密码环境变量，增加了跨场景的操作复杂度。由于没有可验证的自动化安装测试或 CI 证据，按静态评审规则易用性上限为 15 分，结合上述额外配置负担进一步扣分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么连接数据库

适合谁

已经在使用 DBX 桌面端/Web端/Docker并配置好数据库连接的开发者
需要在多种不同数据库引擎间统一操作的团队
希望使用轻量级（20MB）客户端而无需 Java/Python 运行时的用户

不适合谁

尚未安装或未在 DBX 中配置数据库连接的用户（MCP Server 本身不包含数据库连接管理能力，依赖已有的 DBX 连接配置）
需要由数据库厂商官方（如 MySQL、PostgreSQL、MongoDB 官方项目）维护的 MCP 实现的用户，而非 DBX 自研的客户端封装
对自动化写权限有严格审计要求、且无法在部署环境中确认 DBX 集中 MCP 策略配置状态的场景

所需权限

访问 DBX 中已配置的数据库连接凭据
根据 DBX 设置 → MCP 中选择的模式（只读 / 数据读写 / 完全访问）执行 SQL 语句
Web/Docker 部署场景下需要 DBX_WEB_URL，如启用密码登录还需 DBX_WEB_PASSWORD
Windows 便携版需要 DBX_DATA_DIR 指向包含 dbx.db 的数据目录
通过 npx 运行时需要 Node.js >= 18（也可使用无需 Node.js 的预编译原生二进制文件）

风险与副作用

若权限模式设置为「数据读写」或「完全访问」，AI 代理可能修改或删除数据库中的数据
AI 生成的 SQL 若审核不足，可能对生产数据库执行非预期的写操作
遗留环境变量 DBX_MCP_ALLOW_WRITES=0 仅在尚未保存过集中 MCP 策略前生效为只读限制，一旦保存过策略即失效，需注意配置状态
DBX_WEB_PASSWORD 以明文形式存储在客户端配置中，需妥善保护配置文件

安装接入

准备工作

运行环境：Node.js · 预编译二进制

DBX_WEB_PASSWORD 可选密钥 Web 登录密码，Web 登录需要密码时在 MCP 配置中设置相同值。

其他可选配置项（3 个）

DBX_WEB_URL 可选 DBX Web/Docker 部署的后端 API 地址，如 http://localhost:4224，仅 Web/Docker 模式需要。

DBX_DATA_DIR 可选 Windows 便携版需指向 DBX.exe 旁的 data 目录（包含 dbx.db）。

DBX_MCP_ALLOW_WRITES 可选旧版兼容变量，设为 0 或 false 表示只读限制，且无法启用写入。

确认已安装并配置好 DBX（桌面端、Web 或 Docker 部署），且已在其中添加好数据库连接。
在 .mcp.json 中添加配置：npx -y @dbx-app/mcp-server（stdio 传输），或从 GitHub Releases 下载对应平台的预编译原生二进制文件（无需 Node.js）。
在 DBX 设置 → MCP 中管理连接白名单，并选择权限模式：只读（read_only）、数据读写（safe_write）或完全访问（high_risk_write）。
若连接的是 DBX Web/Docker 部署，需设置环境变量 DBX_WEB_URL 指向后端 API 地址；若 Web 登录页需要密码，还需设置 DBX_WEB_PASSWORD。
Windows 便携版需要在配置中设置 DBX_DATA_DIR，指向 DBX.exe 旁边包含 dbx.db 的 data 目录。

.mcp.json

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

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add dbx -- npx -y @dbx-app/mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端中确认出现 DBX 提供的连接列表/表浏览/SQL 执行等工具，或直接让它执行 "select 1" 验证数据库连接可用。

常见排障

确认 DBX 主应用已安装并已配置好至少一个数据库连接，因为 MCP Server 是独立分发的，不会随 DBX 应用自动安装
使用 npx 方式启动失败时，检查本地 Node.js 版本是否 >= 18，或改用 GitHub Releases 中提供的预编译原生二进制文件
Windows 便携版连接不到数据时，检查是否设置了 DBX_DATA_DIR 并正确指向 DBX.exe 旁边包含 dbx.db 的 data 目录
连接 Web/Docker 部署的 DBX 后端失败时，检查 DBX_WEB_URL 是否正确，以及登录页启用密码时是否设置了匹配的 DBX_WEB_PASSWORD
如遇写操作被意外允许或拒绝，检查 DBX 设置 → MCP 中的权限模式（read_only / safe_write / high_risk_write）及连接白名单配置

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我在 DBX 中配置的所有数据库连接
查看 mydb 连接里有哪些表
在 local 连接上执行 select 1
在 DBX 界面中打开 users 表

使用场景

在 Claude Code、Cursor、Windsurf 等编辑器内直接查询和浏览 DBX 中已配置的数据库，无需切换工具

让 AI 代理列出可用连接、浏览表结构、执行 SQL 并将结果与 DBX 界面联动查看

在覆盖 70+ 数据库引擎的多数据库环境中，通过统一的 MCP 入口进行探索性查询和轻量数据操作

支持客户端

Claude Code

Cursor

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

DBX 是一款仅 20MB 的跨平台数据库管理工具，支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、DuckDB、SQL Server、达梦等 70+ 数据库。其 MCP Server 是一个基于 Rust 的独立 npm 包（@dbx-app/mcp-server），通过 stdio 传输运行，使 Claude Code、Cursor、Windsurf 等 AI 编码代理可以复用 DBX 桌面端/Web 端/Docker 部署中已配置的数据库连接，进行连接列举、表浏览、SQL 执行，并可直接在 DBX 界面中打开对应的表。该 MCP Server 与 DBX 主应用分开发布，安装 DBX 并不会自动安装 MCP 可执行文件。

Dbx