跨源查询
本地 CSV / Excel 与 MySQL / PostgreSQL 在同一条 SQL 里 JOIN。远程库经 ATTACH 接入。
本地优先的跨源 SQL 工作台
用 DuckQuery 构建
把文件和线上库放进同一条 SQL
把本地文件和线上库，放进同一条 SQL 里查
CSV / Excel 拖进来就是表；MySQL / PostgreSQL 连上就能 JOIN。可视化用 DuckDB，不必先写脚本搭环境。
本地优先 · 数据留在你的机器 · AI 使用你自己配置的模型端点
一条语句可同时触及这些源
CSVExcelParquetJSONMySQLPostgreSQLSQLiteDuckDBMCP
核心能力
文件入表、跨源 JOIN、问数与图表、MCP 自动化——在一个本地优先的工作台里完成。
数据智能体
中文提问，自主只读探查后给结论，并附上可复用 SQL。草稿不自动执行。
MCP 自动化
让 Claude Code / Cursor 直接操作本机后端：查询、接入、导出。
适合什么时候用
临时联查、对账探查、可视化用 DuckDB——不必先建仓或手写脚本。
01
可视化用 DuckDB，不用手写脚本
把 DuckDB 的本地分析能力放进工作台——拖文件成表、点选 JOIN / 透视、结果直接出图；不必先写 Python / CLI 脚本搭环境。
02
对账 / 临时分析
业务甩来一份 Excel，要和库里的订单对上号——不想为一次分析去导库或排数仓。
03
跨源探查
本地 Parquet / SQLite 要和远端 MySQL 探一眼 JOIN，不想起一堆客户端来回倒。
04
用 AI 写代码时
希望 Cursor / Claude 直接查你本机已连的数据，而不是把 CSV 贴进聊天框。
在线 Demo 仅含浏览器内 DuckDB-Wasm（无 AI、无数据库连接、无 Excel）。完整能力请用桌面版或 Docker。
30 秒上手
01
把数据放进来
Excel / CSV 拖入即成表，或连接 MySQL / PostgreSQL / SQLite / DuckDB 文件。
02
提问，或写 SQL
用中文问「上月各城市实付」；或让 AI 起草 SQL，你检查后再执行。
03
看结果，并带走
同一份查询结果在表格与图表间切换，点击下钻，导出给同事。
本地文件与远程库，同一条语句
导入的文件成为 DuckDB 表，MySQL / PostgreSQL 等通过 ATTACH 参与查询，可直接跨源 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 下载对应安装包。
在线 Demo
浏览器即可体验 SQL。仅 DuckDB-Wasm：无 AI、无数据库连接、无 Excel。
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 文档。