用 DBX MCP Server 让编码智能体直查数据库：零配置接入与只读安全分级实操

先在桌面端把地基打好——从 GitHub releases 下载对应平台的独立二进制，解压即用，然后添加一条连接：

# DBX 桌面端：新建连接
#   类型: PostgreSQL   主机: localhost   端口: 5432
#   填完点测试连接，能列出 schema 即成功

# MCP Server 从这个 SQLite 库读连接配置（自动，零配置）：
#   macOS   : ~/Library/Application Support/com.dbx.app/dbx.db
#   Linux   : ~/.config/com.dbx.app/dbx.db
#   Windows : %APPDATA%\com.dbx.app\dbx.db

关键设计在这里：连接密码存进系统钥匙串，MCP Server 自动读取，整个过程中智能体看不到也拿不到凭据本体——它调用工具时只报「用哪条连接」，鉴权由 DBX 层完成。这就是「连接配置一次，智能体直接用」的实现基础。

MCP Server 是个 npm 包，装法有两种，推荐 npx 直跑：

# 方式 A：npx 直接运行（推荐，免全局安装）
npx @dbx-app/mcp-server

# 方式 B：全局安装
npm install -g @dbx-app/mcp-server

# Claude Code：项目根目录 .mcp.json
{
  "mcpServers": {
    "dbx": {
      "command": "npx",
      "args": ["-y", "@dbx-app/mcp-server"]
    }
  }
}

配置写进 .mcp.json 后重启 Claude Code 会话，确认 MCP 工具列表里出现了 dbx_ 开头的八个工具，接入就完成了。Cursor、Windsurf、VS Code 的配置结构相同，都是往各自的 MCP 配置里加同一段 mcpServers。

八个工具覆盖了查库的全部动作，先过一遍清单：

dbx_list_connections    列出 DBX 里配置的全部连接
dbx_add_connection      新增连接
dbx_remove_connection   删除连接
dbx_list_tables         列出某连接下的表与视图
dbx_describe_table      看表的列定义
dbx_get_schema_context  拿适合 AI 写 SQL 的紧凑表结构上下文
dbx_execute_query       执行 SQL（最多返回 100 行）
dbx_open_table          在 DBX 桌面端打开表

其中 dbx_get_schema_context 值得单独点名：它把表结构压缩成适合大模型消费的紧凑上下文，比原始 DDL 省得多 token——让智能体写 SQL 之前先调它，准确率和成本都会更好看。dbx_execute_query 的 100 行返回上限是硬编码的防护，防止一次失控查询把上下文窗口冲爆。

接入完成后，在 Claude Code 里用人话指挥即可，典型的五连问：

# 在编码智能体里依次说：
"列出我的数据库连接"
"看看 local-pg 上有哪些表"
"描述一下 users 表的结构"
"查一下最近 7 天的订单数量"
"在 DBX 里打开 orders 表"

智能体的标准动作序列是：list_connections 确认有哪些库、get_schema_context 或 describe_table 搞清结构、然后写 SQL 调 execute_query。你只需要盯两件事——它生成的 SQL 是否合理、返回结果是否对得上预期。对关键数字，让它把 SQL 贴出来，你在 DBX 桌面端里跑一遍对照，形成核对习惯。

顺带交代一下 DBX 本体的底子，方便你判断它适不适合自己的工具链：20MB 量级的跨平台客户端，没有捆绑 Chromium，低配机器上启动比动辄几百 MB 的重型数据库 IDE 快得多；支持 PostgreSQL、MySQL、SQLite、MongoDB、Redis、DuckDB、ClickHouse 等常见类型，查询历史可搜索可回放，危险语句执行前有安全确认弹窗，CSV、Parquet 文件可以直接拖进去预览。MCP Server 是它的延伸而非全部——就算暂时不让智能体接库，把它当轻量客户端替换掉臃肿的旧工具也是合理选择，客户端与 MCP 两层的配置互不干扰。

这是本篇最重要的一节。dbx_execute_query 默认只读，写操作与危险语句被分层拦截：

# 默认：拦截一切写操作（INSERT / UPDATE / DELETE）
# 解锁写操作（仍拦截危险 DDL）：
DBX_MCP_ALLOW_WRITES=1

# 再解锁危险语句（DROP / TRUNCATE / ALTER）：
DBX_MCP_ALLOW_DANGEROUS_SQL=1

# UI 侧还有权限档位：Settings -> MCP
#   read-only / safe write / full access + 连接白名单

推荐的生产姿势：环境变量永远保持默认（只读），需要写操作的场景去 DBX 桌面端的 Settings 里按连接开档位——read-only 给日常查询，safe write 给数据订正，full access 只留给明确受控的运维连接，再配上连接白名单圈定智能体可触达的范围。层层加锁看着繁琐，但每一层都对应一类真实事故。

把能力的边界说清楚，避免配到一半发现路线不对：

# 直接执行（MCP Server 直连数据库）：
#   PostgreSQL / MySQL / SQLite / Doris / StarRocks / Redshift
#
# 桥接执行（走 DBX 桌面端）：
#   其他类型数据库的查询、表列表、字段读取
#   前提：DBX 桌面端正在运行；或配置 DBX_WEB_URL 用 Web 后端
#
# dbx_open_table：需要 DBX 桌面端运行中（本地 HTTP 通信）

也就是说 PostgreSQL 和 MySQL 用户体验最完整——装完 MCP 就能脱离 DBX 运行；用其他数据库（MongoDB、Redis、ClickHouse 等）的，MCP Server 会把请求转给运行中的 DBX 桌面端处理，桌面端关了查询就不通。dbx_open_table 的 UI 联动同理：它通过本地 HTTP 接口唤起 DBX 打开对应表，适合让智能体在查完数据后顺手把表丢到界面里给你人肉复核。