motherduckdb/mcp-server-motherduck

解決的問題

本專案提供一個 Model Context Protocol (MCP) 伺服器，讓 AI 助手與 IDE 可直接與 DuckDB 和 MotherDuck 互動。它彌補了 LLM 與分析型 SQL 資料庫之間的差距，使 AI 代理能對本機檔案、記憶體資料庫、S3 儲存的資料庫或雲端的 MotherDuck 實例執行資料工程與 SQL 分析。

如何運作

伺服器作為中介層，將 DuckDB 的 SQL 引擎作為一組工具提供給 MCP 相容的客戶端（如 Claude Desktop、Cursor 或 VS Code）。支援多種連接模式——包含唯讀與讀寫模式——並可在執行時即時切換不同資料庫連接。可透過 uvx 在本機部署，或使用 stdio 或 http 傳輸方式以 Docker 容器形式部署。

適用對象

• 資料工程師與分析師：希望使用 AI 助手查詢與管理其分析資料的人
• AI 代理開發者：需要具備執行 SQL 與瀏覽資料庫目錄能力的代理開發者
• IDE 使用者：使用 AI 驅動的 IDE（如 Cursor 或 VS Code）並希望將資料來源直接整合至編碼工作流程的使用者

主要特色

• 多樣的連接性：支援本機 DuckDB 檔案、記憶體資料庫、S3 儲存的資料庫與 MotherDuck
• 彈性的存取控制：提供預設的唯讀模式，以及適用於生產環境的特定安全設定之讀寫模式
• 完整的工具集：包含執行查詢、列出資料庫、資料表與欄位，以及切換資料庫連接的工具
• 廣泛的客戶端支援：相容多種 MCP 客戶端，包括 Claude Desktop、Claude Code、Gemini CLI 與 Cursor