MotherDuck

DuckDB / MotherDuck Local MCP Server

AI सहायकों और IDEs के लिए SQL एनालिटिक्स और डेटा इंजीनियरिंग।

DuckDB के शक्तिशाली विश्लेषणात्मक SQL इंजन का उपयोग करके AI सहायकों को अपने डेटा से कनेक्ट करें। स्थानीय DuckDB फ़ाइलों, इन-मेमोरी डेटाबेस, S3-होस्टेड डेटाबेस और MotherDuck से कनेक्शन का समर्थन करता है। SQL रीड- और राइट-क्वेरी निष्पादित करने, डेटाबेस कैटलॉग ब्राउज़ करने और विभिन्न डेटाबेस कनेक्शनों के बीच तुरंत स्विच करने की अनुमति देता है।

MotherDuck के लिए पूरी तरह से प्रबंधित रिमोट MCP सर्वर खोज रहे हैं? → MotherDuck Remote MCP दस्तावेज़ पर जाएं

रिमोट बनाम लोकल MCP

त्वरित प्रारंभ

पूर्वापेक्षाएँ: uv को pip install uv या brew install uv के माध्यम से इंस्टॉल करें

इन-मेमोरी DuckDB से कनेक्ट करना (डेव मोड)

{
  "mcpServers": {
    "DuckDB (in-memory, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", ":memory:", "--read-write", "--allow-switch-databases"]
    }
  }
}

बिना किसी गार्डरेल के पूर्ण लचीलापन — रीड-राइट एक्सेस और रनटाइम पर किसी भी डेटाबेस (स्थानीय फ़ाइलें, S3, या MotherDuck) पर स्विच करने की क्षमता।

स्थानीय DuckDB फ़ाइल से रीड-ओनली मोड में कनेक्ट करना

{
  "mcpServers": {
    "DuckDB (read-only)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "/absolute/path/to/your.duckdb"]
    }
  }
}

किसी विशिष्ट DuckDB फ़ाइल से रीड-ओनली मोड में कनेक्ट होता है। फ़ाइल लॉक को धारण नहीं करता, इसलिए उसी DuckDB फ़ाइल में राइट कनेक्शन के साथ उपयोग करना सुविधाजनक है। आप s3://bucket/path.duckdb का उपयोग करके S3 पर रिमोट DuckDB फ़ाइलों से भी कनेक्ट कर सकते हैं — S3 प्रमाणीकरण के लिए पर्यावरण चर देखें। यदि आप MCP तक तृतीय-पक्ष पहुंच पर विचार कर रहे हैं, तो उत्पादन के लिए सुरक्षा देखें।

MotherDuck से रीड-राइट मोड में कनेक्ट करना

{
  "mcpServers": {
    "MotherDuck (local, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "md:", "--read-write"],
      "env": {
        "motherduck_token": "<YOUR_MOTHERDUCK_TOKEN>"
      }
    }
  }
}

अधिक विकल्पों के लिए कमांड लाइन पैरामीटर देखें, तैनाती मार्गदर्शन के लिए उत्पादन के लिए सुरक्षा देखें, और समस्याओं का सामना करने पर समस्या निवारण देखें।

क्लाइंट सेटअप

क्लाइंट	कॉन्फ़िग स्थान	वन-क्लिक इंस्टॉल
Claude Desktop	सेटिंग्स → डेवलपर → कॉन्फ़िग संपादित करें	.mcpb (MCP बंडल)
Claude Code	नीचे CLI कमांड का उपयोग करें	-
Codex CLI	नीचे CLI कमांड या ~/.codex/config.toml का उपयोग करें	-
Gemini CLI	नीचे CLI कमांड या ~/.gemini/settings.json का उपयोग करें	-
Cursor	सेटिंग्स → MCP → नया ग्लोबल MCP सर्वर जोड़ें
VS Code	Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"
Kiro	~/.kiro/settings/mcp.json (ग्लोबल) या .kiro/settings/mcp.json (प्रोजेक्ट)

कोई भी MCP-संगत क्लाइंट इस सर्वर का उपयोग कर सकता है। त्वरित प्रारंभ से JSON कॉन्फ़िगरेशन को अपने क्लाइंट के MCP कॉन्फ़िग फ़ाइल में जोड़ें। कॉन्फ़िग फ़ाइल स्थान के लिए अपने क्लाइंट के दस्तावेज़ देखें।

claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

claude mcp add --scope user duckdb --transport stdio -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

claude mcp add --scope user motherduck --transport stdio --env motherduck_token=YOUR_TOKEN -- uvx mcp-server-motherduck --db-path md: --read-write

codex mcp add duckdb -- uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

codex mcp add duckdb -- uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

codex mcp add motherduck --env motherduck_token=YOUR_TOKEN -- uvx mcp-server-motherduck --db-path md: --read-write

gemini mcp add -s user duckdb uvx mcp-server-motherduck --db-path :memory: --read-write --allow-switch-databases

gemini mcp add -s user duckdb uvx mcp-server-motherduck --db-path /absolute/path/to/db.duckdb

gemini mcp add -s user -e motherduck_token=YOUR_TOKEN motherduck uvx mcp-server-motherduck --db-path md: --read-write

{
  "mcpServers": {
    "DuckDB (in-memory, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", ":memory:", "--read-write", "--allow-switch-databases"]
    }
  }
}

{
  "mcpServers": {
    "MotherDuck (local, r/w)": {
      "command": "uvx",
      "args": ["mcp-server-motherduck", "--db-path", "md:", "--read-write"],
      "env": {
        "motherduck_token": "<YOUR_MOTHERDUCK_TOKEN>"
      }
    }
  }
}

उपकरण

*--allow-switch-databases फ़्लैग की आवश्यकता है

सभी उपकरण JSON लौटाते हैं। परिणाम डिफ़ॉल्ट रूप से 1024 पंक्तियों / 50,000 वर्णों तक सीमित हैं (--max-rows, --max-chars के माध्यम से कॉन्फ़िगर करने योग्य)।

उत्पादन के लिए सुरक्षा

जब तृतीय पक्षों को स्व-होस्टेड MCP सर्वर तक पहुंच दी जाती है, रीड-ओनली मोड अकेले पर्याप्त नहीं है — यह अभी भी स्थानीय फ़ाइल सिस्टम तक पहुंच, DuckDB सेटिंग्स बदलने और अन्य संभावित संवेदनशील संचालन की अनुमति देता है।

तृतीय-पक्ष पहुंच के साथ उत्पादन तैनाती के लिए, हम MotherDuck Remote MCP की अनुशंसा करते हैं — शून्य-सेटअप, रीड-राइट सक्षम, और MotherDuck द्वारा होस्ट किया गया।

MotherDuck MCP को स्व-होस्ट करना: इस रिपॉजिटरी को फोर्क करें और आवश्यकतानुसार अनुकूलित करें। स्थानीय फ़ाइल एक्सेस को प्रतिबंधित करने के लिए रीड-स्केलिंग टोकन के साथ सेवा खाता का उपयोग करें और SaaS मोड सक्षम करें।

DuckDB MCP को स्व-होस्ट करना: सुरक्षा सेटिंग्स लागू करने के लिए --init-sql का उपयोग करें। उपलब्ध विकल्पों के लिए DuckDB सुरक्षा गाइड देखें।

Docker

पोर्ट 8000 पर Streamable HTTP के साथ सर्वर बनाएं और चलाएं (डिफ़ॉल्ट रूप से इन-मेमोरी DuckDB):

docker build -t mcp-server-motherduck .
docker run --rm -p 8000:8000 mcp-server-motherduck

टोकन पास करके और कमांड को ओवरराइड करके MotherDuck से कनेक्ट करें:

docker run --rm -p 8000:8000 \
  -e motherduck_token="$MOTHERDUCK_TOKEN" \
  mcp-server-motherduck --transport http --db-path md:

MCP एंडपॉइंट http://localhost:8000/mcp पर उपलब्ध है। नीचे दिए गए CLI फ़्लैग और env vars अभी भी लागू होते हैं।

कमांड लाइन पैरामीटर

पर्यावरण चर

समस्या निवारण

• spawn uvx ENOENT: uvx का पूर्ण पथ निर्दिष्ट करें (इसे खोजने के लिए which uvx चलाएं)
• फ़ाइल लॉक: सुनिश्चित करें कि --ephemeral-connections चालू है (डिफ़ॉल्ट: true) और आप रीड-राइट मोड में कनेक्ट नहीं हैं

संसाधन

• MotherDuck MCP दस्तावेज़
• Close the Loop: Faster Data Pipelines with MCP, DuckDB & AI (ब्लॉग)
• Faster Data Pipelines with MCP and DuckDB (YouTube)

विकास

स्रोत से चलाने के लिए:

{
  "mcpServers": {
    "Local DuckDB (Dev)": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-server-motherduck", "run", "mcp-server-motherduck", "--db-path", "md:"],
      "env": {
        "motherduck_token": "<YOUR_MOTHERDUCK_TOKEN>"
      }
    }
  }
}

रिलीज़ प्रक्रिया

1. Release New Version GitHub Action चलाएं
2. MAJOR.MINOR.PATCH प्रारूप में संस्करण दर्ज करें
3. वर्कफ़्लो संस्करण बढ़ाता है, PyPI/MCP रजिस्ट्री पर प्रकाशित करता है, और MCPB पैकेज के साथ GitHub रिलीज़ बनाता है

लाइसेंस

MIT लाइसेंस - LICENSE फ़ाइल देखें।

mcp-name: io.github.motherduckdb/mcp-server-motherduck