MotherDuck MCP 服务器

“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

1. 确认已安装 Node.js 和 Windsurf。

2. 打开 Windsurf 配置文件（通常为 windsurf.config.json）。

3. 在 mcpServers 部分添加 MotherDuck MCP 服务器：

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. 保存配置并重启 Windsurf。

5. 在 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

1. 安装 Claude 并确保已设置 Node.js。

2. 找到 Claude 配置文件（通常为 claude.config.json）。

3. 在 mcpServers 中添加如下内容：

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. 重启 Claude 并在界面确认服务器已出现。

5. 按上述方式通过环境变量保护 API 密钥。

Cursor

1. 确认已安装并更新 Cursor。

2. 打开 Cursor 设置（cursor.config.json）。

3. 在 mcpServers 下添加以下内容：

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

4. 保存并重启 Cursor。

5. 通过环境变量设置敏感令牌。

Cline

1. 安装 Cline 及所需依赖。

2. 编辑 cline.config.json，加入如下内容：

   {
     "mcpServers": {
       "motherduck": {
         "command": "uvx",
         "args": ["mcp-server-motherduck", "--transport", "stream", "--db-path", "md:"]
       }
     }
   }
   

3. 保存配置并重启 Cline。

4. 确保已将 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 服务器地址。

概览

通过以上两张表可以看出，MotherDuck MCP 服务器文档完善，包含清晰的提示、工具支持、资源和安全实践，但没有明确提及 Roots 和采样支持。总体而言，它是一个实用、面向数据库分析的 MCP 接口实现。

MCP 评分