שרת ה-MCP של DuckDB, אומת בריצה חיה על Mac אמיתי.

• כלים

  4, נספרו בריצה חיה

• אישורי גישה

  לא נדרשים לקובץ מקומי

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [3]

• מתחזק

  motherduckdb, רשמי [3][4]

• הורדות

  9,555 בשבוע האחרון ב-PyPI [2]

• רישיון

  MIT [3]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם uvx על גבי stdio, כשהוא מכוון לקובץ DuckDB זמני באמצעות ‎--db-path ו-‎--read-write, השלמנו את לחיצת היד של MCP, קראנו ל-tools/list והרצנו קריאת כלי אמיתית אחת: execute_query עם השאילתה SELECT 42 AS answer, שחזרה עם שורה. לא הוגדר שום אישור גישה, כי קובץ מסד נתונים על ה-Mac שלכם אינו זקוק לאחד. ה-JSON הגולמי נלכד ישירות מהחיבור, וטבלת הכלים למטה היא הלכידה הזו, מילה במילה. על ה-Mac הזה רצה uvx 0.10.2; גרסת ה-Node ברצועה למעלה שייכת ללקוח הבדיקה שלנו, כי השרת עצמו כתוב ב-Python ואינו זקוק ל-Node. ארבע ריצות נוספות נעשו בכוונה כדי לשבור דברים, וכל שגיאה שהן החזירו מודפסת בהמשך.

[motherduck] INFO - 🦆 MotherDuck MCP Server v1.0.7
[motherduck] INFO - Ready to execute SQL queries via DuckDB/MotherDuck
[motherduck] INFO - Database mode: read-write
[motherduck] INFO - Query result limits: 1024 rows, 50,000 characters
[motherduck] INFO - Query timeout: disabled
[motherduck] INFO - Database client initialized in `duckdb` mode
[motherduck] INFO - FastMCP server created
[motherduck] INFO - MCP server initialized in stdio mode
[motherduck] INFO - Waiting for client connection


╭──────────────────────────────────────────────────────────────────────────────╮
│                                                                              │
│                                                                              │
│                         ▄▀▀ ▄▀█ █▀▀ ▀█▀ █▀▄▀█ █▀▀ █▀█                        │
│                         █▀  █▀█ ▄▄█  █  █ ▀ █ █▄▄ █▀▀                        │
│                                                                              │
│                                                                              │
│                                                                              │
│                                FastMCP 3.4.5                                 │
│                            https://gofastmcp.com                             │
│                                                                              │
│                 🖥  Server:      mcp-server-motherduck, 1.0.7                 │
│                 🚀 Deploy free: https://horizon.prefect.io                   │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯


[08/03/26 23:58:50] INFO     Starting MCP server                transport.py:241
                             'mcp-server-motherduck' with                       
                             transport 'stdio'                                  
[motherduck] INFO - Processing request of type ListToolsRequest
[motherduck] INFO - Processing request of type CallToolRequest
[motherduck] INFO - 🔌 Connecting to duckdb database
[motherduck] INFO - ✅ Successfully connected to duckdb database

tools/call execute_query {"sql": "SELECT 42 AS answer"}

{
  "success": true,
  "columns": [
    "answer"
  ],
  "columnTypes": [
    "INTEGER"
  ],
  "rows": [
    [
      42
    ]
  ],
  "rowCount": 1
}

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 4 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

{
  "mcpServers": {
    "duckdb": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "/Users/yourname/Documents/analytics.duckdb",
        "--read-write"
      ]
    }
  }
}

claude mcp add --transport stdio duckdb -- uvx mcp-server-motherduck --db-path /Users/yourname/Documents/analytics.duckdb --read-write

{
  "mcpServers": {
    "duckdb": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "/Users/yourname/Documents/analytics.duckdb",
        "--read-write"
      ]
    }
  }
}

Name        DuckDB
Command     uvx
Arguments   mcp-server-motherduck --db-path /Users/yourname/Documents/analytics.duckdb --read-write

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ DuckDB בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואתם מעדיפים שכך יישאר, זה כמעט המסלול שלכם: התקנה אחת עומדת בדרך, ואחריה אין מה להקליד. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.

1. 01

   התקינו את Routines, ולצדה את uv

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו. השרת הזה הוא חבילת Python, ולכן הוא זקוק גם ל-uv, הכלי שמספק את הפקודה uvx. התקינו אותה מ-astral.sh/uv, או בשורת טרמינל אחת אם כבר יש לכם Homebrew: brew install uv.

2. 02

   פתחו את הגדרות ה-MCP

   לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

3. 03

   בחרו Command (stdio)‎

   העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה שרצה על ה-Mac שלכם, לא כתובת אינטרנט. Name: DuckDB. Command: uvx.

4. 04

   כוונו אותו לקובץ מסד נתונים

   Arguments: ‎mcp-server-motherduck --db-path, אחריו רווח והנתיב המלא של קובץ ה-DuckDB שלכם, למשל ‎/Users/yourname/Documents/analytics.duckdb, ואז ‎--read-write אם העוזר אמור לקבל רשות ליצור ולשנות טבלאות. כתבו את הנתיב במלואו, מתחיל ב-/Users, בלי רווחים. הקובץ לא חייב להתקיים מראש, אבל התיקיה שסביבו כן.

5. 05

   בדקו, ואז הוסיפו

   השאירו את Environment Variables ריק: קובץ מסד נתונים על ה-Mac שלכם אינו זקוק לאישור גישה, וזה החלק שהעמוד הזה מוכיח ולא רק מצטט. היוצא מן הכלל הוא מצב הענן של MotherDuck, שדורש כאן שורה אחת, motherduck_token. לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, ארבעה עבור השרת הזה. אחר כך לחצו Add Server.

6. 06

   השתמשו בו

   הכלים עובדים בצ׳אט מיד: שאלו את השאלה שלכם במילים רגילות ותנו לעוזר לכתוב את ה-SQL. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

1 validation error for call[execute_query]
sql
  Missing required argument [type=missing_argument, input_value={}, input_type=dict]
    For further information visit https://errors.pydantic.dev/2.13/v/missing_argument

Error calling tool 'execute_query': {
  "success": false,
  "error": "Parser Error: syntax error at or near \"SELEKT\"\n\nLINE 1: SELEKT this is not valid sql\n        ^",
  "errorType": "ParserException"
}

Unknown tool: 'execute_qeury'

Error calling tool 'execute_query': {
  "success": false,
  "error": "Invalid Input Error: Initialization function \"motherduck_duckdb_cpp_init\" from file \"/Users/[REDACTED]/.duckdb/extensions/v1.5.3/osx_amd64/motherduck.duckdb_extension\" threw an exception: \"Invalid Error: Request failed: Your request is not authenticated. Please check your MotherDuck token. (Jwt is not in the form of Header.Payload.Signature with two dots and 3 sections, request id: '819fc96d-2d4a-4040-a6c7-f9f492433eb3')\"",
  "errorType": "InvalidInputException"
}

Error calling tool 'execute_query': {
  "success": false,
  "error": "IO Error: Cannot open file \"/definitely/not/a/real/directory/nope.duckdb\": No such file or directory",
  "errorType": "IOException"
}

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

1. [1]

   PyPI registry: mcp-server-motherduckנקרא בתאריך 2026-08-03

   Latest version 1.0.7, published 2026-06-09. Requires Python 3.10 or newer. Published to PyPI, with no npm package of this name.

2. [2]

   PyPI download stats: recentנקרא בתאריך 2026-08-03

   9,555 downloads in the last seven days at access time, and 43,674 in the last thirty.

3. [3]

   GitHub: motherduckdb/mcp-server-motherduckנקרא בתאריך 2026-08-03

   506 stars, an MIT license, not archived, and a push dated 2026-07-27 per the GitHub API. Its README publishes the uvx command, the JSON config block and the stdio transport.

4. [4]

   GitHub: the motherduckdb organizationנקרא בתאריך 2026-08-03

   MotherDuck Corporation, the company behind the hosted DuckDB service, owns the package.

5. [5]

   PulseMCP: MotherDuck and DuckDB serverנקרא בתאריך 2026-08-03

   Lists this package as the official MotherDuck and DuckDB MCP server.

6. [6]

   modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

   Where the Claude Desktop config file lives and the mcpServers command and args shape.

7. [7]

   Claude Code docs: MCPנקרא בתאריך 2026-08-03

   The claude mcp add [options] <name> -- <command> [args...] syntax, including --transport and --env.

8. [8]

   Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

   The mcp.json shape and file locations.

9. [9]

   Routines: Connectorsנקרא בתאריך 2026-08-03

   How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את DuckDB כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.