# Reported issues for dbx

Pod holds 23 of 103 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [dbx](/mcp/dbx).

## Most discussed

### 希望添加选中代码右键截图功能

### 数据库类型和版本

通用

### 支持信息

DBX 版本: v0.5.86
运行环境: 桌面端
操作系统: macOS 12.7.6
系统架构: x86_64

### 当前痛点

希望能添加一个和VSCode当中CodeSnap插件一样的截图功能, 方便截图代码使用

<img width="500" height="145" alt="Image" src="https://github.com/user-attachments/assets/ce784804-ffe2-4e7a-bb80-fac594f5f59b" />

### 期望方案

希望在下一个版本能实现加入这个功能, 也方便我在教学过程中, 截图给学生

### 优先级（是否紧急）

🟠 P1 重要 · 尽快处理

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/6498) · 2026-08-18 · closed · external user · 11 comments

### [0.4.63] dbx_list_tables and dbx_describe_table parameter parsing still fails

## Description

After upgrading to @dbx-app/mcp-server@0.4.63 (which includes the fix from #6285), dbx_list_tables and dbx_describe_table still have the same parameter parsing issue.

## Partially Fixed

| Tool | Status |
|------|--------|
| dbx_list_connections | ✅ Works |
| dbx_execute_query | ✅ Works |
| dbx_get_schema_context | ✅ Works |
| dbx_list_tables | ❌ Still fails |
| dbx_describe_table | ❌ Still fails |

## Reproduction for dbx_list_tables

**Parameters:**
`json
{
  "connection_name"

[Read the thread](https://github.com/t8y2/dbx/issues/6344) · 2026-08-15 · closed · external user · 5 comments

### [Bug] 无法配置国内平台code plan

### 数据库类型和版本

通用

### 问题描述

<img width="3188" height="2052" alt="Image" src="https://github.com/user-attachments/assets/c28b822d-ffc7-47c0-bbfd-bae90239a869" />
**以国内火山云code plan为例**

- Authentication无论选择api key还是auth token；
- API Key无论是否携带Bearer ；
- Endpoint无论最后写不携带v3；
- api无论选择三个选项中任何一个

**以上操作都无法正常请求成功大模型**

### 支持信息

DBX 版本: v0.5.69
运行环境: 桌面端
操作系统: Ubuntu 24.04.4 LTS 24.04
系统架构: x86_64

### 优先级（是否紧急）

🟠 P1 重要 · 尽快处理

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/4859) · 2026-07-30 · closed · external user · 4 comments

### [Bug] Single quotes in SQL WHERE clause are stripped when using `dbx_execute_query`

### 数据库类型和版本

MySQL 8.0 

### 问题描述

### Description

When using the `dbx_execute_query` MCP tool with a SQL query containing single quotes in the WHERE clause, the query fails with a MySQL syntax error. The single quotes appear to be stripped or improperly escaped during the MCP tool's SQL parsing/serialization.

### Steps to Reproduce

1. Connect to a MySQL database via DBX MCP
2. Execute a query with a WHERE clause using single-quoted string values:

```sql
SELECT OrderId, OrderNo FROM  order 

[Read the thread](https://github.com/t8y2/dbx/issues/3561) · 2026-07-15 · closed · external user · 5 comments

### [Bug]  MCP 的 dbx_execute_query 会把 SQL 里的字符串字面量吞掉

### 数据库类型和版本

 PostgreSQL 17.6

### 问题描述

## 问题

通过 MCP 调 `dbx_execute_query`，SQL 里只要有字符串字面量（`'abc'` 或 `$$abc$$`），就报语法错误。看报错位置，字符串是被整个删掉之后才发给 PG 的。

## 复现

| SQL | 结果 |
| --- | --- |
| `SELECT 1 AS x` | 正常 |
| `SELECT "id" FROM t LIMIT 1` | 正常 |
| `SELECT 'abc' AS x` | 报错 `syntax error at or near "AS"` |
| `SELECT 'it''s' AS x` | 同样报错 |
| `SELECT $$abc$$ AS x` | 同样报错 |
| `SELECT count(*) FROM t WHERE col IN ('a','b')` | 报错 `syntax error at or near ")"` |

`SELECT 'abc' AS x` 的报错等价于 PG 收到了 `SELEC

[Read the thread](https://github.com/t8y2/dbx/issues/3405) · 2026-07-14 · closed · external user · 4 comments

### [Bug] MCP 在不同类型连接同名时未区分数据库类型导致路由错乱

### 数据库类型和版本

Redis 与 MySQL 等不同数据库类型的多连接场景。具体版本待补充。

### 问题描述

使用 DBX 的 MCP 能力时，如果存在两个不同数据库类型的连接，但连接名称相同，例如：

- Redis 连接，名称为 `test`
- MySQL 连接，名称也为 `test`

通过 MCP 调用时，当前逻辑似乎没有同时区分“连接名称 + 数据库类型/驱动类型”，导致请求可能被路由到错误类型的连接。

复现路径示例：

1. 在 DBX 中配置一个 Redis 连接，连接名称为 `test`。
2. 再配置一个 MySQL 连接，连接名称也为 `test`。
3. 通过 MCP 发起本应查询 MySQL 的 SQL 请求。
4. MCP 实际可能匹配到同名的 Redis 连接，导致使用 Redis 连接执行本应走 MySQL 的查询。

期望结果：

MCP 在定位连接时应能区分数据库类型/驱动类型，并使用唯一连接标识定位目标连接。即使多个连接名称相同，也不应仅凭名称匹配。

实际结果：

当 Redis 和 MySQL 等不同类型连接使用相同名称时，M

[Read the thread](https://github.com/t8y2/dbx/issues/2973) · 2026-07-09 · closed · external user · 4 comments

### [❓ Question] MCP Tool 'dbx_add_connection' 返回错误: "Failed to load DBX connections from /root/.config/com.dbx.app/dbx.db: no such table: connections"

### 描述

linux 如果无法安装桌面版，按照npm安装后，有办法用mcp吗？
安装npm DBX-cli好像都没有初始化dbx.db的操作，linux mcp启动提示无connection的表，有大佬在linux里面启用成功mcp服务嘛？求教

### 环境信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/1613) · 2026-06-23 · closed · external user · 3 comments

### [🔀 Compatibility]Doris 3.1.4 连接串参数不支持包括5个： useLocalSessionState,rewriteBatchedStatements,prepStmtCacheSqlLimit,prepStmtCacheSize,sessionVariables

### 数据库类型和版本

Doris 3.1.4

### 问题描述

连接串参数不支持包括5个：
useLocalSessionState,rewriteBatchedStatements,prepStmtCacheSqlLimit,prepStmtCacheSize,sessionVariables

<img width="1263" height="827" alt="Image" src="https://github.com/user-attachments/assets/cd0d7970-d39b-42ce-ae54-36e8c7ea5927" />

### 错误信息

```shell
Invalid MySQL URL: Unknown connection URL parameter `useLocalSessionState'
```

### DBX 版本

v0.5.29

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/743) · 2026-06-04 · closed · outside contributor · 4 comments

## Most recent

### [Feature] MCP 支持一次调用批量执行完整 SQL 脚本

### 数据库类型和版本

通用（DBX MCP）

### 支持信息

DBX 版本：未提供
运行环境：MCP Server
操作系统：未提供
系统架构：未提供

### 当前痛点

目前 DBX MCP 的 dbx_execute_query 无法在一次工具调用中执行包含多条语句的完整 SQL 脚本。调用方只能自行拆分 SQL，并逐条调用 MCP。

这会带来：
- 多次 MCP 往返，执行效率低；
- SQL 拆分容易被字符串、注释、存储过程中的分号干扰；
- 中途失败时，调用方难以获得统一的逐语句执行结果；
- 需要按顺序执行的一组 DDL/DML 或初始化脚本无法作为一个批次提交。

### 期望方案

希望 MCP 支持一次调用批量执行完整 SQL 脚本。可以增强 dbx_execute_query，或新增 dbx_execute_batch / dbx_execute_multi 工具。

建议行为：
1. 接收包含多条 SQL 语句的脚本文本，并使用数据库方言感知的解析器拆分，正确处理字符串、注释、函数或存储过程中的分号；
2. 对每条语句继续执行现有权限策略和安全检查

[Read the thread](https://github.com/t8y2/dbx/issues/7548) · 2026-08-29 · open · external user · 2 comments

### [Feature] MCP连接查询超时不能设置

### 数据库类型和版本

通用

### 支持信息

DBX 版本: v0.5.97
运行环境: 桌面端
操作系统: Windows 10.0.26200.8655
系统架构: x86_64

### 当前痛点

MCP连接查询超时不能设置

### 期望方案

希望可以自己在MCP配置页面配置超时时间

### 优先级（是否紧急）

🟠 P1 重要 · 尽快处理

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/7473) · 2026-08-28 · open · external user · 2 comments

### [Bug] MYSQL URL配置ssl-model=preferred，导致MCP无法访问该数据库

### 数据库类型和版本

MySql 8.0.32-24

### 问题描述

## 问题概述

连接一台启用了 TLS、且使用 MySQL 自动生成的自签名证书的 MySQL 8.0 服务器时，
DBX MCP server 进程会整个崩溃。客户端只能看到 `MCP error -32000: Connection closed`，
没有任何可供诊断的信息。

由于 MySQL 8.0 **默认**就会启用 TLS 并自动生成自签名证书，任何标准安装的
MySQL 8.0 实例似乎都会触发该问题。

## 环境信息

- DBX 版本：v0.5.97
- 操作系统：Windows 11 Pro (26100)
- 触发方式：MCP 工具 `dbx_execute_query`
- 服务端：MySQL 8.0.32-24 (Percona Server)，已启用 TLS，使用自动生成的证书
- 连接配置：`ssl-mode=preferred`

## 复现步骤

1. 启动一台标准的 MySQL 8.0 服务器（TLS 开启，使用自动生成的自签名证书）。
2. 在 DBX 中新建一

[Read the thread](https://github.com/t8y2/dbx/issues/7408) · 2026-08-27 · closed · external user · 2 comments

### [Feature] MCP的权限控制细化颗粒度

### 数据库类型和版本

通用

### 支持信息

DBX 版本: v0.5.96
运行环境: 桌面端
操作系统: Windows 10.0.26200.9168
系统架构: x86_64

### 当前痛点

只能设置数据库连接的白名单，只读、完全控制是针对整个白名单的，但同样允许访问的数据库连接之间，也需要不同的访问权限控制。

### 期望方案

例如 测试库完全访问，测试库允许读写，演示库只读~~

### 优先级（是否紧急）

🟡 P2 普通 · 按排期处理

### 补充信息

<img width="1363" height="756" alt="Image" src="https://github.com/user-attachments/assets/6c55548f-de7f-4f8a-94fb-008501c8ddf1" />

[Read the thread](https://github.com/t8y2/dbx/issues/7384) · 2026-08-27 · closed · external user · 1 comment

### [Feature] Oracle 新增活动跟踪功能

### 数据库类型和版本

Oracle 11g

### 支持信息

DBX 版本: v0.5.94
运行环境: 桌面端
操作系统: Windows 10.0.17763.316
系统架构: x86_64

### 当前痛点

目前SQL server支持活动跟踪，希望Oracle同样可以支持，包括默认驱动及JDBC连接

### 期望方案

新增对应功能

### 优先级（是否紧急）

🟠 P1 重要 · 尽快处理

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/7373) · 2026-08-27 · open · external user · 0 comments

### [Feature] 能不能添加类似table plus 似的快捷键配置

### 数据库类型和版本

通用

### 支持信息

DBX Version: v0.5.94
Runtime: Desktop
Operating System: macOS 15.4.1
Architecture: x86_64

### 当前痛点

感觉有快捷键更方便

### 期望方案

cmd + k 选择数据库
cmd + shift + k 选择连接
cmd + f 直接定位sql查询框

### 优先级（是否紧急）

🟡 P2 普通 · 按排期处理

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/7267) · 2026-08-26 · open · external user · 0 comments

### [Feature] MCP执行权限配置可以分链接独立配置

### 数据库类型和版本

mysql 8

### 支持信息

DBX版本：v0.5.95
运行环境：桌面端
操作系统：macos15.5
系统架构：aarch64

### 当前痛点

目前MCP的权限配置是所有链接同时生效的。但是有的链接我希望是读写权限，但是另外一些链接我只希望是只读权限。

### 期望方案

MCP执行权限配置可以分链接独立配置。
允许一个全局的配置，同时也允许每个链接独立配置。
独立配置优先于全局配置。

### 优先级（是否紧急）

🟠 P1 重要 · 尽快处理

### 补充信息

无

[Read the thread](https://github.com/t8y2/dbx/issues/7242) · 2026-08-26 · open · external user · 1 comment

### [Feature] 希望支持 mivus 向量数据库

### 数据库类型和版本

mivus 2.x

### 支持信息

DBX 版本: v0.5.93
运行环境: 桌面端
操作系统: Windows 10.0.26200.9168
系统架构: x86_64

### 当前痛点

支持向量数据库 mivus 2.x

### 期望方案

支持向量数据库 mivus 2.x

### 优先级（是否紧急）

🔴 P0 紧急 · 下个版本必须做

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/7086) · 2026-08-24 · closed · external user · 1 comment

### [Feature] 支持打包为独立 exe 版本以简化安装

### 来源
QQ 群反馈 · **反馈人**：Admin

### AI 摘要
用户建议将 MCP 工具打包为独立可执行文件（exe），不依赖 npm 环境，以便测试人员等非开发用户能够一次性安装成功，降低安装门槛。

### 原始描述
mcp 这个有没有可能做成独立 exe 版本不依赖 npm，比如测试人员让他装这玩意能一次装好的真不多。

[Read the thread](https://github.com/t8y2/dbx/issues/6794) · 2026-08-20 · closed · external user · 1 comment

### [Feature] MCP增加ZCODE支持

### 数据库类型和版本

all

### 支持信息

all

### 当前痛点

MCP增加ZCODE支持

### 期望方案

MCP增加ZCODE支持

### 优先级（是否紧急）

🔴 P0 紧急 · 下个版本必须做

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/6763) · 2026-08-20 · closed · external user · 3 comments

### [Feature] 我使用想直接使用agent 接入mcp 工具后，帮我添加sql语句存储到 sql 库/ 查询文件夹下

### 数据库类型和版本

通用

### 支持信息

DBX 版本: v0.5.88
运行环境: 桌面端
操作系统: Windows 10.0.26100.8655
系统架构: x86_64

### 当前痛点

我使用想直接使用agent 接入mcp 工具后，帮我添加sql语句存储到 sql 库/ 查询文件夹下

### 期望方案

也就是说mcp功能支持 sql 语句存储到 sql语句存储库中，增删改查等

### 优先级（是否紧急）

🟡 P2 普通 · 按排期处理

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/6755) · 2026-08-20 · open · external user · 0 comments

### [Feature] MCP配置支持CodeBuddy

### 数据库类型和版本

通用

### 支持信息

DBX 版本: v0.5.88
运行环境: 桌面端
操作系统: Windows 10.0.22000.2538
系统架构: x86_64

### 当前痛点

mcp配置不支持codebuddy

### 期望方案

mcp配置支持codebuddy

### 优先级（是否紧急）

🔴 P0 紧急 · 下个版本必须做

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/6729) · 2026-08-20 · closed · external user · 1 comment

### [Bug] SQL SERVER查询时不能使用分页查询

### 数据库类型和版本

SQL SERVER 2016

### 问题描述

在查询中使用了【OFFSET 0 ROWS FETCH NEXT 62000 ROWS ONLY;】 查询报错 【Token error: '不能在同一查询或子查询中将 TOP 用作 OFFSET。' 】

### 支持信息

DBX 版本: v0.5.88
运行环境: 桌面端
操作系统: Windows 10.0.19045.6456
系统架构: x86_64

### 优先级（是否紧急）

🔴 P0 紧急 · 下个版本必须修

### 补充信息

_No response_

[Read the thread](https://github.com/t8y2/dbx/issues/6628) · 2026-08-19 · closed · external user · 2 comments

### [Feature] Allow to specify headers at AI Config UI

### 数据库类型和版本

AI Config

### 支持信息

DBX version: latest

### 当前痛点

I want to configure my AI Gateway (GoModel) so DBX can use my own models. But there is no way to add custom headers, which is neccessary to specify [User Path](https://gomodel.enterpilot.io/docs/features/user-path). In GoModel AI Gateway, the API keys belong to User Path.

<img width="2880" height="1920" alt="Image" src="https://github.com/user-attachments/assets/8626d414-918a-4bd2-a622-6d4a2a154551" />

### 期望方案

There is a new

[Read the thread](https://github.com/t8y2/dbx/issues/6528) · 2026-08-18 · open · external user · 0 comments

### [Bug] MCP v0.4.65 升级失败：npm EBUSY 资源锁定

### 来源
QQ 群反馈 · **反馈人**：十九遇她

### AI 摘要
用户升级 MCP 至最新版本 v0.4.65 时安装失败。npm 报错 EBUSY，在 copyfile 过程中目标文件 dbx-mcp.exe 被占用或锁定，错误码 -4082。升级无法完成，需要解决文件占用问题。

### 原始描述
MCP最新版本 v0.4.65 升级失败
Installation failed: npm error code EBUSY npm error syscall copyfile npm error path D:\HuanJing\nvm\22.10.0\node_modules\@dbx-app\mcp-server\node_modules\@dbx-app\mcp-win32-x64\bin\dbx-mcp.exe npm error dest D:\HuanJing\nvm\22.10.0\node_modules\@dbx-app\.mcp-server-e2c3hN30\node_modules\@dbx-app\mcp-win32-x64\bin\dbx-m

[Read the thread](https://github.com/t8y2/dbx/issues/6502) · 2026-08-18 · open · external user · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/t8y2/dbx/issues).