freemcplab / الدليل / الملعب / DuckDB MCP

● مجتمع ktanaka101 ⚡ فوري

DuckDB MCP

Name: DuckDB MCP MCP Server
Author: ktanaka101

بواسطة ktanaka101 · ktanaka101/mcp-server-duckdb

Spin up a local DuckDB and let Claude run SQL, inspect schemas, and analyse parquet/CSV files — perfect for ad-hoc analytics on laptops.

DuckDB MCP is a Model Context Protocol server maintained by ktanaka101. Spin up a local DuckDB and let Claude run SQL, inspect schemas, and analyse parquet/CSV files — perfect for ad-hoc analytics on laptops. See README for installation and configuration: https://github.com/ktanaka101/mcp-server-duckdb

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

Spin up a local DuckDB and let Claude run SQL, inspect schemas, and analyse parquet/CSV files — perfect for ad-hoc analytics on laptops.
Language: Python
174+ GitHub stars at verification time
Community project

عرض مباشر

كيف يبدو في الممارسة

duckdb-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "duckdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-duckdb"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "duckdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-duckdb"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "duckdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-duckdb"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "duckdb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-duckdb"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "duckdb-mcp",
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-duckdb"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "duckdb-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-server-duckdb"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add duckdb-mcp -- npx -y mcp-server-duckdb

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: DuckDB MCP

Use DuckDB MCP for its primary workflow

👤 Claude Code users ⏱ ~20 min intermediate

متى تستخدمه: See repo README for canonical use cases.

المتطلبات الأساسية

Repo cloned or installed — See https://github.com/ktanaka101/mcp-server-duckdb

الخطوات

Install

Install DuckDB MCP per README.✓ تم النسخ

→ Tool registered with client
Configure

Provide credentials/config as instructed.✓ تم النسخ

→ Successful auth/init
Use

Run a sample task with DuckDB MCP.✓ تم النسخ

→ Expected output

النتيجة: You can drive the documented workflow end-to-end.

المزالق

Skipping README — Read the repo README and CHANGELOG before shipping to prod.

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
primary	see README	Primary action	free

التكلفة والحدود

تكلفة التشغيل

حصة API: None of its own; bounded by upstream provider quotas if any
الرموز لكل استدعاء: Depends on usage
التكلفة المالية: Open source — check repo LICENSE
نصيحة: Review upstream API costs (if any) before automating.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: Whatever the upstream provider requires

تخزين بيانات الاعتماد: Env vars or local config — never commit secrets

نقل البيانات الخارجي: Forwards data per its README

لا تمنح أبدًا: Full admin to untrusted prompts

Project moves fast — pin a version in production.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Auth fails

Verify credentials and required scopes match README.

تحقق: Re-read repo README auth section.

Tool not found by client

Ensure MCP client config points to correct command/path.

تحقق: Restart the client after editing config.