MotherDuck

DuckDB / MotherDuck स्थानीय MCP सर्वर

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

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

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

रिमोट बनाम स्थानीय MCP

📝 v0.x से माइग्रेट कर रहे हैं?

• डिफ़ॉल्ट रूप से केवल-पढ़ने के लिए: सर्वर अब डिफ़ॉल्ट रूप से केवल-पढ़ने के मोड में चलता है। राइट एक्सेस सक्षम करने के लिए --read-write जोड़ें। उत्पादन के लिए सुरक्षित करना देखें।
• डिफ़ॉल्ट डेटाबेस बदला गया: --db-path डिफ़ॉल्ट md: से बदलकर :memory: हो गया। MotherDuck के लिए स्पष्ट रूप से --db-path md: जोड़ें।
• MotherDuck केवल-पढ़ने के लिए रीड-स्केलिंग टोकन की आवश्यकता है: केवल-पढ़ने के मोड में MotherDuck कनेक्शन के लिए रीड-स्केलिंग टोकन की आवश्यकता होती है। नियमित टोकन के लिए --read-write की आवश्यकता होती है।

त्वरित शुरुआत

पूर्वापेक्षाएँ: pip install uv या brew install uv के माध्यम से 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 → "प्राथमिकताएँ: उपयोगकर्ता सेटिंग्स खोलें (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 रिमोट MCP की अनुशंसा करते हैं — शून्य-सेटअप, रीड-राइट सक्षम, और MotherDuck द्वारा होस्टेड।

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

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

Docker

पोर्ट 8000 पर स्ट्रीमेबल 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 दस्तावेज़ीकरण
• लूप बंद करें: MCP, DuckDB और AI के साथ तेज़ डेटा पाइपलाइन (ब्लॉग)
• MCP और 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