MotherDuck MCP Server

这个 MCP 服务器为 Claude 提供 SQL 分析能力，集成了基于云的 MotherDuck 和本地 DuckDB。

🔑 准备工作

1. 创建 MotherDuck 账户
2. 生成 访问令牌
3. 安装 uv：pip install uv 或 brew install uv

📋 功能简介

• 混合执行：同时查询云端和本地数据
• 云存储集成：访问 Amazon S3 等云存储中的数据
• 无需配置实例或集群即可运行分析

🚀 与 Claude Desktop 集成

1. 下载 Claude Desktop
2. 在 Claude Desktop 中，进入设置 → 开发者 → 编辑配置
3. 添加以下配置:

"mcpServers": {
  "mcp-server-motherduck": {
    "command": "uvx",
    "args": [
      "mcp-server-motherduck",
      "--db-path",
      "md:",
      "--motherduck-token",
      "<YOUR_MOTHERDUCK_TOKEN_HERE>"
    ]
  }
}

注意：将 <YOUR_MOTHERDUCK_TOKEN_HERE> 替换为您的实际令牌

🔍 使用示例

配置完成后，您可以要求 Claude 执行以下操作：

• 创建数据库和表
• 查询本地 CSV 文件
• 结合本地和云端数据进行分析
• 分析存储在 S3 中的数据

🔧 手动测试

# 连接到默认 MotherDuck 数据库
uvx mcp-server-motherduck --db-path md: --motherduck-token <your_token>

# 连接到特定 MotherDuck 数据库
uvx mcp-server-motherduck --db-path md:your_database_name --motherduck-token <your_token>

# 连接到本地 DuckDB 数据库
uvx mcp-server-motherduck --db-path /path/to/your/local.db

# 使用内存数据库
uvx mcp-server-motherduck --db-path :memory:

💡 故障排除

• 验证 MotherDuck 令牌是否正确
• 确保 uvx 在 PATH 中可用
• 遇到 spawn uvx ENOENT 错误时，使用 uvx 的完整路径

📄 许可证

根据 MIT 许可证发布。