MCP Server Motherduck

🚀 母親鴨MCP服務器中文文檔

本項目提供了母親鴨MCP服務器的安裝、配置、使用等相關說明，幫助用戶快速搭建並使用該服務器。

🚀 快速開始

安裝與配置

使用Claude Desktop

1. 若尚未安裝Claude Desktop，可從claude.ai/download下載並安裝。
2. 打開Claude Desktop的配置文件：
   • 首次使用時，可在Claude Desktop應用程序中操作：選擇“設置”，進入“開發者”選項卡，點擊“編輯配置”按鈕。
   • 在claude_desktop_config.json文件中添加如下配置：

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

⚠️ 重要提示

• 請將<YOUR_MOTHERDUCK_TOKEN_HERE>替換為您的實際MotherDuck令牌。
• 可根據需要設置--home-dir參數（例如：--home-dir /Users/your_username）。

使用VS Code

您可以在.vscode/mcp.json文件中添加以下配置，也可將此內容直接複製到工作區的mcp.json文件中：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "motherduck_token",
      "description": "MotherDuck令牌",
      "password": true
    }
  ],
  "servers": {
    "motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "md:",
        "--motherduck-token",
        "${input:motherduck_token}"
      ]
    }
  }
}

💻 使用示例

示例查詢

配置完成後，您可以讓Claude執行以下操作：

• “創建新的數據庫和表在MotherDuck中”
• “從本地CSV文件查詢數據”
• “將本地DuckDB數據庫中的數據與MotherDuck中的表格連接”
• “分析存儲在Amazon S3中的數據”

測試方法

默認MotherDuck數據庫

要連接到默認的MotherDuck數據庫，需要使用--motherduck-token參數指定令牌：

uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>

指定MotherDuck數據庫

uvx mcp-server-motherduck --db-path md:your_database_name --motherduck-token <your_motherduck_token>

本地DuckDB數據庫

uvx mcp-server-motherduck --db-path /path/to/your/local.db

內存數據庫

uvx mcp-server-motherduck --db-path :memory:

💡 使用建議

如果未指定數據庫路徑但設置了motherduck_token環境變量，服務器將自動連接到默認的MotherDuck數據庫（md:）。

🔧 技術細節

運行在SSE模式

要以SSE模式運行服務器，請使用supergateway工具：

npx -y supergateway --stdio "uvx mcp-server-motherduck --db-path md: --motherduck-token <your_motherduck_token>"

故障排除

注意事項：

1. 確保已正確安裝所有依賴項。
2. 檢查命令語法是否正確。
3. 如遇到spawn uvx ENOENT錯誤，請確認uvx工具已正確安裝並位於系統路徑中。

📄 許可證

本項目遵循MIT許可證。更多信息請參考MIT License。