MotherDuck MCP Server

基本能力

产品定位

MotherDuck MCP Server 是一个为 Claude 提供 SQL 分析能力的服务器，支持混合查询云端和本地数据。

核心功能

• 混合执行: 查询云端 MotherDuck 和本地 DuckDB 的数据
• 云存储集成: 访问 Amazon S3 等云存储数据
• 数据共享: 创建和共享数据库
• SQL 分析: 使用 DuckDB 的 SQL 方言查询任意大小的数据
• 服务器架构: 无需配置实例或集群即可运行分析

适用场景

• 创建和管理数据库
• 查询本地和云端数据
• 分析存储在云存储中的数据
• 数据共享和协作

工具列表

• query: 执行 SQL 查询
• 输入: query (字符串, 必需): 要执行的 SQL 查询

常见问题解答

• 连接问题: 检查 MotherDuck 令牌是否正确
• 本地文件访问问题: 确保 --home-dir 参数设置正确
• uvx 命令不可用: 检查 PATH 中是否有 uvx
• spawn uvx ENOENT 错误: 尝试指定 uvx 的完整路径

使用教程

使用依赖

• MotherDuck 账户 (在 motherduck.com 注册)
• MotherDuck 访问令牌
• 安装 uv: pip install uv 或 brew install uv

安装教程

1. 在 VS Code 中点击 "Install with UV" 按钮快速安装
2. 或手动添加 JSON 配置到 VS Code 的用户设置中

调试方式

1. 手动启动服务器进行测试:
2. 默认 MotherDuck 数据库: uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>
3. 特定 MotherDuck 数据库: uvx mcp-server-motherduck --db-path md:your_database_name --motherduck-token <your_motherduck_token>
4. 本地 DuckDB 数据库: uvx mcp-server-motherduck --db-path /path/to/your/local.db

5. 内存数据库: uvx mcp-server-motherduck --db-path :memory:

6. 在 SSE 模式下运行: bash npx -y supergateway --stdio "uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。