Blog

كيفية استخدام خادم MCP في DuckDB

Ashley Innocent

Ashley Innocent

16 يونيو 2025

كيفية استخدام خادم MCP في DuckDB

يُحدث خادم DuckDB MCP ثورة في تحليل البيانات من خلال سد الفجوة بين DuckDB، وهي قاعدة بيانات SQL عالية الأداء ومضمنة، والأدوات المعتمدة على الذكاء الاصطناعي مثل Claude أو Cursor أو بيئات التطوير المتكاملة (IDEs) الأخرى التي تدعم بروتوكول سياق النموذج (MCP). يُمكّن هذا الخادم التفاعل السلس بين قاعدة بياناتك ومساعدي الذكاء الاصطناعي، مما يتيح لك تنفيذ استعلامات SQL وفحص المخططات وبناء خطوط أنابيب البيانات بأقل قدر من التدخل اليدوي. سواء كنت تقوم بتحليل مجموعات البيانات المحلية أو الاستفادة من مثيلات MotherDuck السحابية، فإن خادم DuckDB MCP يُمكّن مهندسي البيانات والمحللين والمطورين من تسريع سير العمل واستخلاص الرؤى بشكل أسرع.

💡
لتبسيط عمليات التكامل القائمة على واجهة برمجة التطبيقات (API) مع خادم MCP، قم بتنزيل Apidog مجانًا. يُبسط Apidog اختبار وإدارة واجهات برمجة التطبيقات (APIs)، مما يضمن اتصالًا سلسًا بين أدواتك وخادم DuckDB MCP، ويعزز كفاءة مشروع بياناتك.
تنزيل

فهم خادم DuckDB MCP

DuckDB هو قاعدة بيانات SQL مفتوحة المصدر ومضمنة مصممة لأحمال العمل التحليلية. يدعم مجموعة واسعة من تنسيقات البيانات، بما في ذلك CSV وParquet وJSON، ويمكنه الاستعلام عن كل من الملفات المحلية والمصادر البعيدة مثل AWS S3. يوسع خادم DuckDB MCP، الذي طوره فريق MotherDuck، قدرات DuckDB من خلال دمجه مع بروتوكول سياق النموذج (MCP). يُمكّن هذا البروتوكول أدوات الذكاء الاصطناعي من التفاعل مباشرة مع قواعد بيانات DuckDB، مما يدعم عمليات مثل الاستعلام واستكشاف المخطط وإدارة الجداول من خلال واجهة موحدة.

صورة

يعمل الخادم كجسر بين DuckDB والبيئات التي تعتمد على الذكاء الاصطناعي، مثل Cursor أو Claude، مما يسمح لهذه الأدوات بتنفيذ أوامر SQL وإرجاع النتائج في الوقت الفعلي. يدعم كلا من مثيلات DuckDB المحلية وقواعد بيانات MotherDuck السحابية، مما يوفر مرونة لحالات الاستخدام المتنوعة. بالإضافة إلى ذلك، يتضمن خادم DuckDB MCP ميزات أمان مثل وضع القراءة فقط ورموز التوسع للقراءة، مما يضمن التكامل الآمن مع أدوات الطرف الثالث.

صورة

الفوائد الرئيسية لخادم DuckDB MCP

إليك سبب كون خادم DuckDB MCP نقطة تحول للمحترفين في مجال البيانات:

هذه الميزات تجعل خادم DuckDB MCP أداة أساسية لهندسة البيانات وتحليلها الحديثة.

إعداد خادم DuckDB MCP

لتسخير قوة خادم DuckDB MCP، تحتاج إلى تثبيته وتكوينه بشكل صحيح. يوضح هذا القسم العملية خطوة بخطوة.

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

قبل البدء، تأكد من توفر ما يلي:

صورة

تثبيت DuckDB

DuckDB هو أساس خادم DuckDB MCP. قم بتثبيته باستخدام إحدى الطرق التالية:

باستخدام Homebrew (لنظام macOS):

brew install duckdb

باستخدام pip (لبايثون):

pip install duckdb

تنزيل الملف الثنائي: قم بزيارة صفحة تثبيت DuckDB للحصول على ملفات ثنائية جاهزة لنظام Windows أو Linux أو macOS.

تحقق من التثبيت بتشغيل:

duckdb --version

يجب أن يعرض هذا إصدار DuckDB، مؤكدًا نجاح الإعداد.

تثبيت خادم MCP

يتم توزيع خادم DuckDB MCP عبر حزمة mcp-server-motherduck. قم بتثبيته باستخدام uv (مفضل لأدوات سطر الأوامر في بايثون) أو pip:

تثبيت uv (اختياري):

pip install uv

تثبيت خادم MCP:

uv pip install mcp-server-motherduck

أو، باستخدام pip:

pip install mcp-server-motherduck

التحقق من التثبيت:

uvx mcp-server-motherduck --version

يجب أن يُرجع هذا الأمر إصدار الخادم، مما يشير إلى نجاح التثبيت.

تكوين خادم MCP

لدمج خادم DuckDB MCP مع بيئة التطوير المتكاملة (IDE) أو أداة الذكاء الاصطناعي الخاصة بك، قم بتكوينه باستخدام ملف JSON. فيما يلي مثال لـ Cursor:

الوصول إلى إعدادات Cursor: انتقل إلى الإعدادات > إعدادات Cursor > MCP > إضافة خادم MCP عالمي جديد.

إنشاء التكوين: أضف تكوين JSON التالي:

{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "md:",
        "--motherduck-token",
        "<رمز_MOTHERDUCK_الخاص_بك_هنا>"
      ]
    }
  }
}

استبدل <رمز_MOTHERDUCK_الخاص_بك_هنا> برمز MotherDuck الخاص بك للوصول السحابي. لقواعد البيانات المحلية، استخدم:

{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "/المسار/إلى/قاعدة/البيانات/المحلية/الخاصة/بك.db"
      ]
    }
  }
}

لقواعد البيانات في الذاكرة، استخدم --db-path :memory:.

تمكين وضع القراءة فقط (اختياري): لمنع تعديل البيانات، أضف العلامة --read-only:

{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "/المسار/إلى/قاعدة/البيانات/المحلية/الخاصة/بك.db",
        "--read-only"
      ]
    }
  }
}

اختبار التكوين: أعد تشغيل بيئة التطوير المتكاملة (IDE) الخاصة بك وقم بتشغيل استعلام اختباري:

SELECT 1 AS test;

إذا نجح الأمر، يُرجع الخادم النتيجة، مؤكدًا الإعداد.

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

يتألق خادم DuckDB MCP في سير عمل البيانات الواقعية. فيما يلي أمثلة مفصلة لكيفية الاستفادة منه في التحليل وتطوير خطوط الأنابيب واستكشاف المخططات.

استعلام البيانات بمساعدة الذكاء الاصطناعي

يُمكّن خادم DuckDB MCP أدوات الذكاء الاصطناعي من تنفيذ استعلامات SQL ومعالجة النتائج ديناميكيًا. على سبيل المثال، افترض أن لديك ملف Parquet مخزنًا على AWS S3 يحتوي على بيانات مبيعات. إليك كيفية الاستعلام عنه باستخدام Cursor:

تكوين الوصول إلى S3: تأكد من أن تكوين خادم MCP الخاص بك يتضمن بيانات اعتماد S3 أو يستخدم تكامل MotherDuck السحابي (--db-path md:).

مطالبة الذكاء الاصطناعي: في Cursor، أدخل مطالبة مثل، "اعرض أفضل 10 سجلات مبيعات من ملف Parquet الخاص بي على s3://my-bucket/sales.parquet، مرتبة حسب الإيرادات."

تنفيذ الاستعلام: يُنشئ الذكاء الاصطناعي ويُشغّل:

SELECT * FROM read_parquet('s3://my-bucket/sales.parquet')
ORDER BY revenue DESC
LIMIT 10;

يُعالج خادم DuckDB MCP الاستعلام ويُرجع النتائج إلى الذكاء الاصطناعي، والذي يمكنه تلخيصها أو اقتراح المزيد من التحليل، مثل التجميع حسب المنطقة.

التكرار على النتائج: اطلب من الذكاء الاصطناعي تحسين الاستعلام، على سبيل المثال، "جمع بيانات المبيعات حسب المنطقة وحساب إجمالي الإيرادات." يُنشئ الذكاء الاصطناعي:

SELECT region, SUM(revenue) AS total_revenue
FROM read_parquet('s3://my-bucket/sales.parquet')
GROUP BY region;

يُقلل سير العمل هذا من كتابة الاستعلامات يدويًا ويسرع استكشاف البيانات.

بناء خطوط أنابيب البيانات باستخدام dbt

يتكامل خادم DuckDB MCP بسلاسة مع dbt، وهي أداة شائعة لتحويل البيانات. إليك كيفية بناء واختبار نماذج dbt باستخدام الخادم:

تهيئة مشروع dbt: أنشئ مشروع dbt جديدًا وقم بتكوين ملف profiles.yml لاستخدام DuckDB أو MotherDuck:

my_project:
  target: dev
  outputs:
    dev:
      type: duckdb
      path: /المسار/إلى/قاعدة/البيانات/المحلية/الخاصة/بك.db
      # أو لـ MotherDuck:
      # path: md:
      # token: <رمز_MOTHERDUCK_الخاص_بك>

إنشاء نماذج التجهيز: اطلب من الذكاء الاصطناعي إنشاء نموذج تجهيز بناءً على بياناتك. على سبيل المثال:

-- models/staging/stg_sales.sql
SELECT
  order_id,
  customer_id,
  sale_date,
  revenue
FROM read_parquet('s3://my-bucket/sales.parquet')
WHERE sale_date >= '2025-01-01';

إضافة الاختبارات: حدد الاختبارات في ملف `.yml` للنموذج لضمان جودة البيانات:

version: 2
models:
  - name: stg_sales
    columns:
      - name: order_id
        tests:
          - not_null
          - unique
      - name: revenue
        tests:
          - positive_values

تشغيل واختبار: نفّذ dbt run لبناء النموذج وdbt test للتحقق منه. يضمن خادم DuckDB MCP تنفيذ الاستعلام بكفاءة، ويمكن للذكاء الاصطناعي اقتراح تحسينات بناءً على نتائج الاختبار.

التكرار مع الذكاء الاصطناعي: استخدم الذكاء الاصطناعي لتحسين النماذج، على سبيل المثال، "أضف عمودًا لنمو الإيرادات على أساس سنوي." يُنشئ الذكاء الاصطناعي كود SQL الضروري، والذي يمكنك دمجه في مشروع dbt الخاص بك.

فحص المخطط واستكشاف البيانات

يدعم خادم DuckDB MCP فحص المخطط، مما يُمكّن أدوات الذكاء الاصطناعي من فهم هيكل قاعدة بياناتك. على سبيل المثال:

مطالبة الذكاء الاصطناعي: اسأل، "صف مخطط جدولي في sales.db."

الاستعلام المُنشأ: يُشغّل الذكاء الاصطناعي:

DESCRIBE SELECT * FROM 'sales.db'.sales_table;

يُرجع الخادم أسماء الأعمدة وأنواع البيانات والقيود، والتي يستخدمها الذكاء الاصطناعي لاقتراح تحويلات أو عمليات ربط أو تجميعات.

استكشاف العلاقات: اطلب من الذكاء الاصطناعي تحديد العلاقات، على سبيل المثال، "ابحث عن الجداول في قاعدة بياناتي التي تحتوي على عمود customer_id." ينفذ الخادم سلسلة من استعلامات DESCRIBE عبر الجداول، ويجمع الذكاء الاصطناعي النتائج.

هذه القدرة لا تقدر بثمن لفهم مجموعات البيانات المعقدة وتخطيط التحويلات.

الميزات المتقدمة لخادم DuckDB MCP

يُقدم خادم DuckDB MCP ميزات متقدمة لتعزيز الأداء والأمان والمرونة.

وضع القراءة فقط والأمان

لحماية البيانات الحساسة، قم بتشغيل خادم DuckDB MCP في وضع القراءة فقط باستخدام العلامة --read-only. يمنع هذا أدوات الذكاء الاصطناعي من تنفيذ استعلامات INSERT أو UPDATE أو DELETE، مما يضمن سلامة البيانات. لمستخدمي MotherDuck، تتيح رموز التوسع للقراءة ما يصل إلى أربع نسخ متماثلة للقراءة المتزامنة، مما يحسن الأداء للعديد من المستخدمين. قم بتكوين هذا في ملف JSON الخاص بك:

{
  "mcpServers": {
    "mcp-server-motherduck": {
      "command": "uvx",
      "args": [
        "mcp-server-motherduck",
        "--db-path",
        "md:",
        "--motherduck-token",
        "<رمز_التوسع_للقراءة_الخاص_بك_هنا>",
        "--saas-mode"
      ]
    }
  }
}

يُقيد وضع SaaS الوصول إلى الملفات المحلية والإضافات، مما يجعله مثاليًا لعمليات النشر السحابية الآمنة.

تكامل التخزين السحابي

يدعم خادم DuckDB MCP استعلام البيانات من منصات التخزين السحابي مثل AWS S3 أو Google Cloud Storage أو Cloudflare R2. على سبيل المثال، للاستعلام عن ملف S3:

SELECT
  customer_id,
  AVG(revenue) AS avg_revenue
FROM read_parquet('s3://my-bucket/sales.parquet')
GROUP BY customer_id;

يتولى الخادم المصادقة واسترجاع البيانات، مما يسمح لأدوات الذكاء الاصطناعي بمعالجة النتائج دون إعداد يدوي.

الاتصالات قصيرة العمر

لسير العمل الذي يتضمن أدوات متعددة (مثل dbt وCursor وJupyter notebooks)، يدعم خادم DuckDB MCP الاتصالات قصيرة العمر في وضع القراءة فقط. يُنشئ كل استعلام اتصالًا مؤقتًا، وينفذه، ثم يغلقه، مما يمنع تعارضات القفل ويحسن التزامن. هذا مفيد بشكل خاص للاستكشاف المتكرر أو البيئات متعددة المستخدمين.

الإضافات المخصصة

يدعم DuckDB الإضافات للوظائف المتقدمة، مثل البحث النصي الكامل أو الاستعلامات الجغرافية المكانية. يمكن لـ خادم DuckDB MCP تحميل هذه الإضافات، شريطة أن تكون متوافقة مع قاعدة بياناتك. على سبيل المثال، لتمكين إضافة httpfs للوصول إلى S3:

INSTALL httpfs;
LOAD httpfs;

قم بتكوين الخادم لتضمين الإضافات في العلامة --extensions إذا لزم الأمر.

تحسين الأداء باستخدام خادم DuckDB MCP

لضمان أداء خادم DuckDB MCP بكفاءة، ضع في اعتبارك هذه التحسينات:

استكشاف الأخطاء الشائعة وإصلاحها

إذا واجهت مشاكل مع خادم DuckDB MCP، جرب هذه الحلول:

الخلاصة

يُعد خادم DuckDB MCP أداة قوية لدمج سير العمل المعتمد على الذكاء الاصطناعي مع قاعدة بيانات DuckDB عالية الأداء. من خلال تمكين الاتصال السلس بين أدوات الذكاء الاصطناعي وقواعد البيانات، فإنه يُبسط تحليل البيانات وتطوير خطوط الأنابيب واستكشاف المخططات. غطى هذا الدليل التثبيت والتكوين وحالات الاستخدام العملية والميزات المتقدمة وأفضل الممارسات لمساعدتك على الاستفادة من الخادم بفعالية.

لتحسين تجربتك مع عمليات التكامل القائمة على واجهة برمجة التطبيقات (API)، قم بتنزيل Apidog مجانًا. يُبسط Apidog اختبار وإدارة واجهات برمجة التطبيقات (APIs)، مما يضمن تشغيل إعداد خادم DuckDB MCP الخاص بك بسلاسة. ابدأ في استكشاف الخادم اليوم لتحويل سير عمل بياناتك وفتح إمكانيات جديدة للتحليل بمساعدة الذكاء الاصطناعي.

الواجهة الرئيسية
تنزيل

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات

التسجيل مجانًاتحميل