MCP Server Motherduck

DuckDB / MotherDuck Local MCP Server

SQL analytics and data engineering for AI Assistants and IDEs.

______________________________________________________________________

使用DuckDB强大的分析SQL引擎将AI助手连接到您的数据。支持连接到本地DuckDB文件、内存数据库、S3托管数据库和MotherDuck。允许执行SQL读写查询、浏览数据库目录以及在不同数据库连接之间动态切换。

正在为MotherDuck寻找完全托管的远程MCP服务器？ → 转到MotherDuck远程MCP文档

远程与本地MCP

📝 从v0.x迁移？ - 默认情况下为只读：默认情况下，服务器现在以只读模式运行。添加 --read-write 以启用写访问。看 确保生产安全. - 默认数据库已更改: --db-path 默认值已更改 md: 到 :memory:.添加 --db-path md: 明确表示为MotherDuck。 - MotherDuck只读需要读取缩放令牌：只读模式下的MotherDuck连接需要 读取缩放标记常规代币需要 --read-write.

快速开始

先决条件：安装 uv 通过 pip install uv 或 brew install uv

连接到内存中的DuckDB（开发模式）

{
  "mcpServers": {
    "DuckDB (in-memory, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", ":memory:", "--read-write", "--allow-switch-databases"]
    }
  }
}

完全灵活，没有护栏——读写访问和在运行时切换到任何数据库（本地文件、S3或MotherDuck）的能力。

以只读模式连接到本地DuckDB文件

{
  "mcpServers": {
    "DuckDB (read-only)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "/absolute/path/to/your.duckdb"]
    }
  }
}

以只读模式连接到特定的DuckDB文件。不会保留文件锁，因此可以方便地与同一DuckDB文件的写连接一起使用。您还可以使用以下命令连接到S3上的远程DuckDB文件 s3://bucket/path.duckdb --看 环境变量 用于S3身份验证。如果您正在考虑第三方访问MCP，请参阅 确保生产安全.

以读写模式连接到MotherDuck

{
  "mcpServers": {
    "MotherDuck (local, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "md:", "--read-write"],
      "env": {
        "motherduck_token": ""
      }
    }
  }
}

看 命令行参数 对于更多选项， 确保生产安全 用于部署指导，以及 故障排除 如果你遇到问题。

客户端设置

任何兼容MCP的客户端都可以使用此服务器。从添加JSON配置 快速开始 到客户的MCP配置文件。有关配置文件的位置，请参阅客户的文档。

Claude Code CLI commands

内存中DuckDB（开发模式）：

claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

本地DuckDB（只读）：

claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

母鸭（读写）：

claude mcp add --scope user motherduck --transport stdio --env motherduck_token=YOUR_TOKEN -- uvx mcp-server-motherduck --db-path md: --read-write

Codex CLI commands

内存中DuckDB（开发模式）：

codex mcp add duckdb -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

本地DuckDB（只读）：

codex mcp add duckdb -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

母鸭（读写）：

codex mcp add motherduck --env motherduck_token=YOUR_TOKEN -- uvx mcp-server-motherduck --db-path md: --read-write

Gemini CLI commands

内存中DuckDB（开发模式）：

gemini mcp add -s user duckdb uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

本地DuckDB（只读）：

gemini mcp add -s user duckdb uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

母鸭（读写）：

gemini mcp add -s user -e motherduck_token=YOUR_TOKEN motherduck uvx mcp-server-motherduck --db-path md: --read-write

工具

\*需要 --allow-switch-databases 旗帜

所有工具都返回JSON。默认情况下，结果限制为1024行/50000个字符（可通过以下方式配置 --max-rows, --max-chars).

确保生产安全

当允许第三方访问自托管MCP服务器时， 仅只读模式是不够的 --它仍然允许访问本地文件系统、更改DuckDB设置和其他潜在的敏感操作。

对于具有第三方访问权限的生产部署，我们建议 母鸭遥控MCP --零设置，支持读写，由MotherDuck托管。

自托管MotherDuck MCP： 分叉此仓库并根据需要进行自定义。使用一个 服务账号 和 读取缩放标记 并启用 SaaS模式 限制本地文件访问。

自托管DuckDB MCP： 使用 --init-sql 应用安全设置。请参阅 保护DuckDB指南 查看可用选项。

命令行参数

环境变量

故障排除

• spawn uvx ENOENT：指定完整路径 uvx （奔跑 which uvx 找到它）
• 文件已锁定：确保 --ephemeral-connections 已打开（默认值：true），并且您未以读写模式连接

资源

• MotherDuck MCP文档
• 闭环：使用MCP、DuckDB和AI实现更快的数据管道（博客）
• 使用MCP和DuckDB（YouTube）实现更快的数据管道

发展

要从源代码运行，请执行以下操作：

{
  "mcpServers": {
    "Local DuckDB (Dev)": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-server-motherduck", "run", "mcp-server-motherduck", "--db-path", "md:"],
      "env": {
        "motherduck_token": ""
      }
    }
  }
}

发布过程

1. 跑吧 Release New Version GitHub行动
2. 输入版本 MAJOR.MINOR.PATCH 格式
3. 工作流升级版本，发布到PyPI/MCP注册表，并使用MCPB包创建GitHub版本

许可证

MIT许可证-请参阅 许可证 文件。

##

mcp名称：io.github.motherduckdb/mcp-server-motherduck