MotherDuck

DuckDB / MotherDuck Local MCP Server

SQL analytics and data engineering for AI Assistants and IDEs.

เชื่อมต่อผู้ช่วย AI เข้ากับข้อมูลของคุณด้วยเอนจิน SQL เชิงวิเคราะห์อันทรงพลังของ DuckDB รองรับการเชื่อมต่อกับไฟล์ DuckDB ในเครื่อง ฐานข้อมูลในหน่วยความจำ ฐานข้อมูลที่โฮสต์บน S3 และ MotherDuck รองรับการรันคิวรี SQL แบบอ่านและเขียน การเรียกดูแคตตาล็อกฐานข้อมูล และการสลับระหว่างการเชื่อมต่อฐานข้อมูลต่างๆ ได้ทันที

กำลังมองหา MCP server ระยะไกลที่จัดการเต็มรูปแบบสำหรับ MotherDuck อยู่หรือไม่? → ไปที่เอกสาร MotherDuck Remote MCP

Remote กับ Local MCP

เริ่มต้นอย่างรวดเร็ว

ข้อกำหนดเบื้องต้น: ติดตั้ง uv ผ่าน pip install uv หรือ brew install uv

การเชื่อมต่อกับ DuckDB ในหน่วยความจำ (โหมด Dev)

{
  "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 เดียวกัน คุณยังสามารถเชื่อมต่อกับไฟล์ DuckDB ระยะไกลบน S3 ได้โดยใช้ s3://bucket/path.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 Bundle)
Claude Code	ใช้คำสั่ง CLI ด้านล่าง	-
Codex CLI	ใช้คำสั่ง CLI ด้านล่างหรือ ~/.codex/config.toml	-
Gemini CLI	ใช้คำสั่ง CLI ด้านล่างหรือ ~/.gemini/settings.json	-
Cursor	การตั้งค่า → MCP → เพิ่ม MCP server ระดับโลกใหม่
VS Code	Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"
Kiro	~/.kiro/settings/mcp.json (ระดับโลก) หรือ .kiro/settings/mcp.json (โปรเจกต์)

ไคลเอนต์ที่เข้ากันได้กับ MCP ใดๆ ก็สามารถใช้ server นี้ได้ เพิ่มการกำหนดค่า 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 server ที่โฮสต์เอง โหมดอ่านอย่างเดียวเพียงอย่างเดียวไม่เพียงพอ — ยังคงอนุญาตให้เข้าถึงระบบไฟล์ในเครื่อง เปลี่ยนการตั้งค่า DuckDB และการดำเนินการที่อาจละเอียดอ่อนอื่นๆ

สำหรับการปรับใช้ในสภาพแวดล้อมการผลิตที่มีการเข้าถึงของบุคคลที่สาม เราขอแนะนำ MotherDuck Remote MCP — ไม่ต้องตั้งค่า รองรับการอ่าน-เขียน และโฮสต์โดย MotherDuck

การโฮสต์ MotherDuck MCP ด้วยตนเอง: Fork repo นี้และปรับแต่งตามความต้องการ ใช้ บัญชีบริการ กับ read-scaling tokens และเปิดใช้งาน โหมด SaaS เพื่อจำกัดการเข้าถึงไฟล์ในเครื่อง

การโฮสต์ DuckDB MCP ด้วยตนเอง: ใช้ --init-sql เพื่อใช้การตั้งค่าความปลอดภัย ดู คู่มือการรักษาความปลอดภัย DuckDB สำหรับตัวเลือกที่มี

Docker

สร้างและรัน server ด้วย Streamable HTTP บนพอร์ต 8000 (ค่าเริ่มต้นคือ DuckDB ในหน่วยความจำ):

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

เชื่อมต่อกับ MotherDuck โดยส่ง token และแทนที่คำสั่ง:

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

MCP endpoint พร้อมใช้งานที่ http://localhost:8000/mcp แฟล็ก CLI และตัวแปรสภาพแวดล้อมด้านล่างยังคงใช้ได้

พารามิเตอร์บรรทัดคำสั่ง

ตัวแปรสภาพแวดล้อม

การแก้ไขปัญหา

• spawn uvx ENOENT: ระบุเส้นทางเต็มไปยัง uvx (รัน which uvx เพื่อค้นหา)
• ไฟล์ถูกล็อก: ตรวจสอบให้แน่ใจว่าเปิดใช้งาน --ephemeral-connections แล้ว (ค่าเริ่มต้น: true) และคุณไม่ได้เชื่อมต่อในโหมดอ่าน-เขียน

ทรัพยากร

• เอกสาร MCP ของ MotherDuck
• 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. รัน GitHub Action Release New Version
2. ป้อนเวอร์ชันในรูปแบบ MAJOR.MINOR.PATCH
3. เวิร์กโฟลว์จะเพิ่มเวอร์ชัน เผยแพร่ไปยัง PyPI/MCP registry และสร้าง GitHub release พร้อมแพ็คเกจ MCPB

ลิขสิทธิ์

ใบอนุญาต MIT - ดูไฟล์ LICENSE

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