适合谁
- 需要在本地或远程数据库上进行 SQL 分析的数据科学家和分析师
- 希望在 IDE 中使用 AI 辅助数据工程的开发者
- 需要快速探索 DuckDB 文件的团队
- 希望结合 MotherDuck 云功能的用户
M
60FMRS · C
这个 MCP 服务器将 AI 助手连接到 DuckDB 和 MotherDuck，提供强大的 SQL 分析能力。它灵活支持本地、内存、S3 和云数据库，并可通过开关控制读写权限。默认只读模式降低了风险，但需注意第三方访问时的安全配置。
这是一个本地 MCP 服务器，将 AI 助手连接到 DuckDB 或 MotherDuck 数据库。它支持对本地 DuckDB 文件、内存数据库、S3 托管的数据库以及 MotherDuck 进行查询。服务器允许执行 SQL 读写查询、浏览数据库目录，并可随时切换不同的数据库连接。默认以只读模式运行，需显式启用写入权限。
工具能力
execute_query
执行 SQL 查询（DuckDB 方言）
list_databases
列出所有数据库
list_tables
列出表或视图
list_columns
列出表或视图的列
switch_database_connection
切换到其他数据库（需 --allow-switch-databases 标志）
安装接入
- 使用 pip 或 brew 安装 uv。2. 将 JSON 配置添加到您的 MCP 客户端配置中，或使用本文档中提供的客户端特定命令。例如，对于内存 DuckDB 开发模式：使用 'uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases'。3. 对于 MotherDuck，请提供访问令牌（通过 --motherduck-token 或环境变量 motherduck_token）。
claude_desktop_config.json
{
"mcpServers": {
"DuckDB (in-memory, r/w)": {
"command": "uvx",
"args": [
"mcp-server-motherduck",
"--db-path",
":memory:",
"--read-write",
"--allow-switch-databases"
]
}
}
}
选型与风险
不适合谁
- 需要完全托管的远程 MCP 服务而不需本地安装的用户
- 需要严格安全的生产环境（默认只读模式仍可访问本地文件系统）
- 需要第三方访问权限且无法接受额外安全配置的用户
所需权限
- 访问本地文件系统（用于读取 DuckDB 文件或导出数据）
- 读取环境变量以获取 MotherDuck 令牌和 AWS 凭据
- 在默认只读模式下执行 SQL 查询，如需写入则需显式启用
- 可选：切换到其他数据库连接（需 --allow-switch-databases）
风险与副作用
- 如果启用写入模式，可能会修改或删除数据库中的数据
- 默认情况下，对第三方开放访问时，可能暴露本地文件系统或敏感数据
- MotherDuck 令牌或 AWS 凭据可能被泄露，如果配置不当
- 查询可能会消耗大量资源（内存、CPU）或超时
常见排障
- 'spawn uvx ENOENT'：请指定 uvx 的完整路径（运行 which uvx）
- 文件被锁定：确保 --ephemeral-connections 已启用（默认开启），且不要以读写模式连接同一文件
- MotherDuck 只读连接需要读扩展令牌；否则请使用 --read-write
- 确保数据库路径正确（如 :memory:、md:、绝对文件路径或 s3:// URL）
使用场景
让 AI 助手分析本地 DuckDB 文件中的数据
对内存中的 DuckDB 数据库进行交互式查询和探索
将本地数据与 MotherDuck 云数据库结合进行分析
在 S3 上查询 DuckDB 数据库
在开发环境中使用 AI 进行数据工程和原型设计
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Codex CLI完整支持
Gemini CLI完整支持
Cursor完整支持
VS Code完整支持
Kiro完整支持