本地优先的跨源 SQL 工作台

用 DuckQuery 构建
把文件和线上库放进同一条 SQL

把本地文件和线上库，放进同一条 SQL 里查

CSV / Excel 拖进来就是表；MySQL / PostgreSQL 连上就能 JOIN。可视化用 DuckDB，不必先写脚本搭环境。

下载桌面版 →在线 Demo Docker 自托管

本地优先 · 数据留在你的机器 · AI 使用你自己配置的模型端点

一条语句可同时触及这些源

CSVExcelParquetJSONMySQLPostgreSQLSQLiteDuckDBMCP

核心能力

文件入表、跨源 JOIN、问数与图表、MCP 自动化——在一个本地优先的工作台里完成。

跨源查询

本地 CSV / Excel 与 MySQL / PostgreSQL 在同一条 SQL 里 JOIN。远程库经 ATTACH 接入。

文件CSV · Excel · Parquet · JSON
数据库MySQL · PostgreSQL · SQLite · DuckDB
方式ATTACH · 半连接下推

数据智能体

中文提问，自主只读探查后给结论，并附上可复用 SQL。草稿不自动执行。

执行只读 · 限行 · 可取消
范围本地表 + 已连接库结构
边界须绑定真实执行过的 SELECT

MCP 自动化

让 Claude Code / Cursor 直接操作本机后端：查询、接入、导出。

工具24 个
模式read-only / normal / full
接入uvx duckquery-mcp

适合什么时候用

临时联查、对账探查、可视化用 DuckDB——不必先建仓或手写脚本。

可视化用 DuckDB，不用手写脚本

把 DuckDB 的本地分析能力放进工作台——拖文件成表、点选 JOIN / 透视、结果直接出图；不必先写 Python / CLI 脚本搭环境。

对账 / 临时分析

业务甩来一份 Excel，要和库里的订单对上号——不想为一次分析去导库或排数仓。

跨源探查

本地 Parquet / SQLite 要和远端 MySQL 探一眼 JOIN，不想起一堆客户端来回倒。

用 AI 写代码时

希望 Cursor / Claude 直接查你本机已连的数据，而不是把 CSV 贴进聊天框。

在线 Demo 仅含浏览器内 DuckDB-Wasm（无 AI、无数据库连接、无 Excel）。完整能力请用桌面版或 Docker。

30 秒上手

把数据放进来

Excel / CSV 拖入即成表，或连接 MySQL / PostgreSQL / SQLite / DuckDB 文件。

提问，或写 SQL

用中文问「上月各城市实付」；或让 AI 起草 SQL，你检查后再执行。

看结果，并带走

同一份查询结果在表格与图表间切换，点击下钻，导出给同事。

本地文件与远程库，同一条语句

导入的文件成为 DuckDB 表，MySQL / PostgreSQL 等通过 ATTACH 参与查询，可直接跨源 JOIN。

cross-source · duckdbATTACH + JOIN

SELECT o.order_id, o.amount, u.city
FROM orders_csv AS o
JOIN mysql.users AS u
  ON o.user_id = u.id
WHERE o.paid_at >= DATE '2026-01-01';

为什么是 DuckQuery

补的是中间这块：临时、跨源、本地可控——不是要替掉日常数据库客户端，也不是要替掉公司级 BI。

类型	典型代表	临时要把本地文件和库放一起查
数据库 GUI	DBeaver、TablePlus	通常要先导入建表
BI 平台	Metabase、Superset	先配数据源；临时分析常要建仓跑 ETL
DuckQuery	—	拖进来即成表；远程库 `ATTACH` 即可查

立即开始

三种形态，按你的环境选一个。

桌面版

macOS（Apple Silicon / Intel）、Windows x64。从 GitHub Releases 下载对应安装包。

打开 Releases

在线 Demo

浏览器即可体验 SQL。仅 DuckDB-Wasm：无 AI、无数据库连接、无 Excel。

打开 Demo

Docker

自托管前后端。数据在宿主机 ./data。镜像源与环境变量见配置参考。

配置参考

Docker 三行启动

git clone https://github.com/Chenkeliang/duckdb-query.git
cd duckdb-query
./quick-start.sh

启动后 Web UI：http://localhost:48000

信任边界

数据留在何处、AI 会看到什么、谁来执行查询。

数据留在你的实例；AI 只打到你配置的模型端点——没有我们的中转服务器，也没有遥测。
AI 起草的 SQL 不会自动执行——只插入编辑器，由你确认后运行。
数据智能体仅可自行执行只读、限行、可取消的探查 SELECT；带数字的回答必须绑定本轮真实执行过的语句。

MCP

先启动桌面版或 Docker 后端，再接入 Claude Code / Cursor。

uvx duckquery-mcp
# 或
claude mcp add duckquery -- uvx duckquery-mcp

模式：read-only / normal（默认）/ full。完整配置见 MCP 文档。

阅读 MCP 文档

用 DuckQuery 构建把文件和线上库放进同一条 SQL