适合谁
- 已经在使用 DBX 桌面端/Web端/Docker并配置好数据库连接的开发者
- 需要在多种不同数据库引擎间统一操作的团队
- 希望使用轻量级（20MB）客户端而无需 Java/Python 运行时的用户
I
57FMRS · C
DBX 是一个采用 Apache-2.0 许可、持续维护的开源项目，曾获 Trendshift、HelloGitHub、Product Hunt 等平台推荐。其 MCP Server 作为独立的 Rust 后端 npm 包发布，提供可配置的只读/读写/完全访问三级权限模式，但需要用户已预先在 DBX 中配置好数据库连接，且启用写权限时需自行评估数据安全风险。
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（桌面端、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目录。
claude_desktop_config.json
{"mcpServers": {"dbx": {"command": "npx", "args": ["-y", "@dbx-app/mcp-server"]}}}
选型与风险
不适合谁
- 尚未安装或未在 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 以明文形式存储在客户端配置中，需妥善保护配置文件
常见排障
- 确认 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）及连接白名单配置
使用场景
在 Claude Code、Cursor、Windsurf 等编辑器内直接查询和浏览 DBX 中已配置的数据库，无需切换工具
让 AI 代理列出可用连接、浏览表结构、执行 SQL 并将结果与 DBX 界面联动查看
在覆盖 70+ 数据库引擎的多数据库环境中，通过统一的 MCP 入口进行探索性查询和轻量数据操作
支持客户端
Claude Code完整支持
Cursor完整支持
Windsurf完整支持