“MotherDuck” MCP 服务器的作用是什么?
MotherDuck MCP 服务器是 Model Context Protocol (MCP) 的一种实现,它将 AI 助手和 IDE 与 DuckDB 及 MotherDuck 数据库对接。它通过为本地 DuckDB 文件和云端 MotherDuck 数据库查询提供标准化接口,使用户能够进行强大的 SQL 分析。该服务器支持混合执行,可无缝访问本地与云存储的数据,包括通过 MotherDuck 集成的 Amazon S3。通过将数据库操作作为工具暴露给 AI 系统,开发者和 AI 代理无需手动配置或服务器管理,即可便捷地执行数据库查询、管理数据和简化数据工作流。这种无服务器方式让分析、数据共享和数据管道开发直接在 AI 环境中得以加速。
提示模板列表
- duckdb-motherduck-initial-prompt:初始化与 DuckDB 或 MotherDuck 的连接并开始数据库操作的提示模板。
资源列表
- 闭环:通过 MCP、DuckDB 和 AI 加速数据管道开发(博客) :介绍 MCP、DuckDB 与 AI 集成加速数据管道开发的博客文章。
- 使用 MCP 和 DuckDB 快速开发数据管道(YouTube) :演示 MCP 与 DuckDB 用于数据管道开发的视频资源。
工具列表
- query:在 DuckDB 或 MotherDuck 数据库上执行 SQL 查询。
- 输入参数:
query(字符串,必填):要执行的 SQL 语句。
- 输入参数:
该 MCP 服务器的应用场景
- AI 助手中的 SQL 分析:让大语言模型或编程助手直接在 DuckDB 或 MotherDuck 上运行 SQL 查询,将自然语言指令转化为可执行的分析操作。
- 数据管道开发:通过让 AI 系统访问本地及云端数据源,加速数据管道的开发和原型设计。
- 混合本地与云查询:支持开发者无缝查询本地(DuckDB)和云端(MotherDuck)数据,提升工作流灵活性。
- 云存储集成:AI 代理可通过 MotherDuck 连接访问并分析 Amazon S3 等集成云存储中的数据。
- 无服务器数据探索:无需管理计算基础设施,实现用户及 AI 系统的快速、按需分析。
如何设置
Windsurf
确认已安装 Node.js 和 Windsurf。
打开 Windsurf 配置文件(通常为
windsurf.config.json)。在
mcpServers部分添加 MotherDuck MCP 服务器:{ "mcpServers": { "motherduck": { "command": "uvx", "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"] } } }保存配置并重启 Windsurf。
在 Windsurf 中确认 MotherDuck MCP 服务器已运行并可访问。
API 密钥安全
使用环境变量提供如 MotherDuck token 等敏感凭证:
{
"mcpServers": {
"motherduck": {
"command": "uvx",
"args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"],
"env": {
"motherduck_token": "${MOTHERDUCK_TOKEN}"
}
}
}
}
Claude
安装 Claude 并确保已设置 Node.js。
找到 Claude 配置文件(通常为
claude.config.json)。在
mcpServers中添加如下内容:{ "mcpServers": { "motherduck": { "command": "uvx", "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"] } } }重启 Claude 并在界面确认服务器已出现。
按上述方式通过环境变量保护 API 密钥。
Cursor
确认已安装并更新 Cursor。
打开 Cursor 设置(
cursor.config.json)。在
mcpServers下添加以下内容:{ "mcpServers": { "motherduck": { "command": "uvx", "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"] } } }保存并重启 Cursor。
通过环境变量设置敏感令牌。
Cline
安装 Cline 及所需依赖。
编辑
cline.config.json,加入如下内容:{ "mcpServers": { "motherduck": { "command": "uvx", "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"] } } }保存配置并重启 Cline。
确保已将
motherduck_token作为环境变量设置以保证安全。
如何在流程中使用该 MCP
在 FlowHunt 中使用 MCP
要将 MCP 服务器集成到 FlowHunt 工作流中,首先添加 MCP 组件并将其连接到您的 AI 代理:

点击 MCP 组件打开配置面板。在系统 MCP 配置部分,使用此 JSON 格式填入您的 MCP 服务器信息:
{
"motherduck": {
"transport": "streamable_http",
"url": "https://yourmcpserver.example/pathtothemcp/url"
}
}
配置完成后,AI 代理即可作为工具使用该 MCP,访问其全部功能和能力。请记住将 "motherduck" 替换为您的 MCP 服务器实际名称,并将 URL 替换为自己的 MCP 服务器地址。
概览
| 部分 | 可用性 | 详情/备注 |
|---|---|---|
| 概览 | ✅ | 见 README.md |
| 提示模板列表 | ✅ | duckdb-motherduck-initial-prompt |
| 资源列表 | ✅ | README.md 中列出两项资源(博客、YouTube 视频) |
| 工具列表 | ✅ | query 工具 |
| API 密钥安全 | ✅ | 使用 motherduck_token 作为环境变量(见 README.md) |
| 采样支持(评估时可忽略) | ⛔ | 未提及 |
通过以上两张表可以看出,MotherDuck MCP 服务器文档完善,包含清晰的提示、工具支持、资源和安全实践,但没有明确提及 Roots 和采样支持。总体而言,它是一个实用、面向数据库分析的 MCP 接口实现。
MCP 评分
| 是否有 LICENSE | ✅ (MIT) |
|---|---|
| 是否有至少一个工具 | ✅ |
| Fork 数量 | 23 |
| Star 数量 | 205 |
