/ الدليل / الملعب / davinci-resolve-mcp
← كل الخوادم ↗ GitHub
● مجتمع samuelgursky ⚡ فوري

davinci-resolve-mcp

بواسطة samuelgursky · samuelgursky/davinci-resolve-mcp

تحكم في DaVinci Resolve من خلال الحوار — بناء الجداول الزمنية، وضبط التحويلات، إضافة الإطارات الرئيسية، تصدير العروض — جميع 324 API البرامج النصية مكشوفة.

davinci-resolve-mcp يوفر لأي عميل MCP السيطرة الكاملة على DaVinci Resolve Studio عبر API البرامج النصية المحلية في Resolve. تغطي 27 أداة مركبة المشاريع والمجموعات الوسائط والجداول الزمنية والإطارات الرئيسية والألوان وتركيبات Fusion والعرض. يتطلب Resolve Studio (وليس الإصدار المجاني) لأن النسخة المجانية تفتقر إلى البرامج النصية.

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

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

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

عرض مباشر

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

davinci-resolve.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "davinci-resolve": {
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "davinci-resolve",
      "command": "uvx",
      "args": [
        "davinci-resolve-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "davinci-resolve": {
      "command": {
        "path": "uvx",
        "args": [
          "davinci-resolve-mcp"
        ]
      }
    }
  }
}

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

claude mcp add davinci-resolve -- uvx davinci-resolve-mcp

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

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

استخدامات عملية: davinci-resolve-mcp

بناء قطع أولية من سيناريو + مجلد اللقطات

👤 محررو الفيديو الذين يعملون على محتوى الرؤوس الناطقة ⏱ ~20 min intermediate

متى تستخدمه: لديك ساعتان من اللقطات الثانوية وسيناريو من 3 صفحات ولا تريد البدء في جدول زمني أسود.

المتطلبات الأساسية
  • DaVinci Resolve Studio 18.5+ مفتوح — شراء مرة واحدة ($295) — الإصدار المجاني لا يحتوي على API البرامج النصية
  • تفضيلات Resolve: النظام > عام > البرامج النصية الخارجية باستخدام: محلي — أعد تشغيل Resolve بعد تبديله
  • MCP مثبت عبر المثبت العام — git clone samuelgursky/davinci-resolve-mcp && python install.py
الخطوات
  1. إنشاء مشروع واستيراد الوسائط
    إنشاء مشروع جديد 'EP04_RoughCut' بدقة 1080p24 واستيراد كل .mov في ~/Footage/EP04 إلى مجلد Media Pool يسمى 'B-roll'.✓ تم النسخ
    → المشروع مفتوح مع ملء المجلد
  2. بناء جدول زمني مرتبط بضربات السيناريو
    إنشاء جدول زمني جديد. لكل فقرة في ~/Footage/EP04/script.md، أضف علامة مدتها 6 ثوانٍ على المسار V2 مع تسمية الكلمات الخمس الأولى.✓ تم النسخ
    → جدول زمني مع علامات الضربات
  3. إفلات اللقطات الثانوية في كل علامة
    في كل علامة، اختر أقرب مقطع لقطات ثانوية مطابقة حسب كلمة رئيسية في اسم الملف وضعها على V1 في تلك العلامة.✓ تم النسخ
    → التجميع المرئي للقطع

النتيجة: قطع أولية يمكنك تحسينها يدويًا، مبنية في 5 دقائق بدلاً من ساعة.

المزالق
  • المطابقة المستندة إلى اسم الملف صاخبة — إعادة تسمية المقاطع بالبادئات الوصفية، أو استخدام Voice Isolation / النسخ المدمج في Resolve للمطابقة الأكثر ذكاءً
  • Resolve بطيء جدًا أثناء تشغيل أدوات MCP على المشاريع الضخمة — العمل في مشروع 'تجميع' أصغر؛ التطابق مع المشروع الكبير لاحقًا
اجمعها مع: filesystem

تطبيق دفعي لإعداد لون مسبق على جدول زمني كامل

👤 خبراء الألوان الذين يقومون بعمل مساعد ⏱ ~15 min intermediate

متى تستخدمه: تريد وضع LUT أساسي + زيادة تشبع عبر 60 مقطعًا قبل بدء الدرجات اليدوية.

الخطوات
  1. فحص هيكل الجدول الزمني
    قائمة بكل مقطع في الجدول الزمني النشط مع الدخول/الخروج واسم ملف المصدر.✓ تم النسخ
    → جرد المقاطع
  2. تطبيق الإعداد المسبق
    لكل مقطع، طبق Power Grade 'EP04_Base' كأول عقدة.✓ تم النسخ
    → تحديث الصور المصغرة
  3. وضع علم على المقاطع التي تبدو خاطئة
    أي مقاطع تبدو خارج النطاق الطبيعي بشكل كبير بعد الإعداد المسبق؟ اقترح تعديلات لكل مقطع.✓ تم النسخ
    → قائمة قصيرة بالمقاطع التي تحتاج إلى انتباه يدوي

النتيجة: تطبيق درجة أساسية متسقة في ثوانٍ، مع علامات الانتباه اليدوي.

تصدير عدة مخرجات من جدول زمني واحد

👤 محررون يسلمون إلى YouTube + Instagram + البث ⏱ ~10 min beginner

متى تستخدمه: نفس القطع، ثلاث مواصفات تصدير، لا تريد النقر عبر صفحة العرض ثلاث مرات.

الخطوات
  1. ضع جميع العروض الثلاثة في قائمة الانتظار
    ضع في قائمة الانتظار العروض للجدول الزمني النشط: YouTube 1080p H.264 إلى ~/Exports/yt.mp4 و Instagram 1080x1350 إلى ig.mp4 و ProRes 422 HQ إلى broadcast.mov.✓ تم النسخ
    → 3 وظائف في قائمة انتظار العرض
  2. البدء والمراقبة
    ابدأ جميع المهام المصفوفة وأبلغ عند الانتهاء.✓ تم النسخ
    → حالة الإنجاز لكل وظيفة

النتيجة: تسليم متعدد الصيغ في دور واحد في الحوار.

اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

davinci-resolve + filesystem

قراءة سيناريو/EDL من القرص والقطع ضده

اقرأ ~/Project/EP04/edl.txt وبناء جدول زمني متطابق في مشروع Resolve الحالي.✓ تم النسخ
davinci-resolve + after-effects

إنهاء VFX في AE ثم توافق العودة إلى Resolve

بعد الانتهاء من عروض AE في ~/renders/vfx/، استبدل المقاطع النائبة المقابلة في الجدول الزمني لـ Resolve بالملفات الجديدة.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
resolve action: str, params?: object مستوى التطبيق: الصفحات والتخطيط وإعدادات العرض المسبقة مجاني (محلي)
project_manager action, params إنشاء/فتح/حذف المشاريع والقواعد البيانات والسحابة مجاني
project action, params الجداول الزمنية وخط أنابيب العرض والإعدادات و LUTs مجاني
media_pool action, params استيراد وتنظيم المقاطع والجداول الزمنية مجاني
timeline action, params المسارات والعلامات والعناصر والمولدات مجاني
timeline_item action, params خصائص كل مقطع وتركيبات Fusion والإصدارات و CDL مجاني
timeline_item_transform item_id, pan?, tilt?, zoom?, rotation? إعادة تموضع/تغيير حجم المقطع مجاني
timeline_item_keyframes item_id, property, frame, value تحريك أي خاصية قابلة للإطار الرئيسي مجاني
gallery action, params الصور الثابتة و Power Grades مجاني
fusion_comp action, params بناء/تعديل رسوم البيانات الموجية Fusion مجاني

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

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

حصة API
بدون شبكة — كل شيء هو API برامج نصية محلية
الرموز لكل استدعاء
معظم الاستجابات 200-800 رمز؛ قد تصل عمليات تفريغ الجدول الزمني إلى 5k على التعديلات الكبيرة
التكلفة المالية
DaVinci Resolve Studio مرة واحدة ~$295 (مطلوب). MCP نفسه مجاني/MIT.
نصيحة
التكلفة هي Resolve Studio ووقت العرض الخاص بك؛ استدعاءات API مجانية. اطلب قوائم ذات نطاق (1 جدول زمني و 1 مسار) وليس عمليات تفريغ المشروع الكاملة.

الأمان

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

تخزين بيانات الاعتماد: لا توجد بيانات اعتماد — برامج نصية محلية فقط
نقل البيانات الخارجي: لا شيء. جميع استدعاءات API تبقى ضمن Resolve.
لا تمنح أبدًا: تعريض شبكة بعيدة لـ MCP — احفظها محليًا

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

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

لا توجد اتصالات لـ DaVinci Resolve

يجب أن يكون Resolve قيد التشغيل و 'البرامج النصية الخارجية باستخدام: محلي' مفعلة؛ أعد تشغيل Resolve بعد التبديل.

تحقق: يعرض التفضيلات > النظام > عام محليًا
الإصدار المجاني: البرامج النصية معطلة

الإصدار المجاني لا يعرض API البرامج النصية. قم بالترقية إلى Studio.

عدم تطابق إصدار Python على macOS

يفضل المثبت Python 3.10-3.12. استخدم pyenv install 3.11.9 وأعد تشغيل install.py.

تحقق: python3 --version
انتهاء المهام على مشروع 4K

API البرامج النصية في Resolve بخيط واحد وقوائم انتظار خلف تحديثات الواجهة. قلل نوافذ عرض Resolve أثناء عمليات الدفع الكبيرة.

البدائل

davinci-resolve-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Adobe Premiere MCPs (مجتمع)خط الأنابيب الخاص بك هو Premiere وليس Resolveنظام بيئي أقل نضجًا لـ MCP لـ Premiere
After Effects MCPتقوم برسومات متحركة وليس تحرير/لونمرحلة مختلفة من خط الأنابيب
Raw Python + Resolve APIتريد السيطرة الكاملة ولا تحتاج إلى ذكاء اصطناعيلا MCP = لا واجهة دردشة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills