Obsidian وExcalidraw مع Claude وCodex

هذا المشروع يجهّز Claude أو Codex أو أي مساعد يدعم MCP لكي يقرأ ويكتب ملاحظاتك، ويفتح رسومات Excalidraw ويعدّلها من داخل Obsidian.

بدل أن تنقل المحتوى بين البرامج أو ترسم كل شيء يدويًا، اطلب ما تريده بالكلام العادي:

رتّب هذه الأفكار في خريطة ذهنية، وارسمها داخل Obsidian، ثم احفظها في مجلد المشروع.

أهم ميزة: دعم السكربتات

المشروع لا يكتفي برسم المربعات والأسهم. يستطيع تشغيل سكربتات Excalidraw الحقيقية من داخل Script Engine، لذلك يمكن للذكاء الاصطناعي استخدام الأدوات التي يستعملها مستخدمو الإضافة المحترفون.

تأتي الحزمة مع 32 سكربتًا جاهزًا، منها:

• بناء الخرائط الذهنية وترتيب العناصر تلقائيًا.
• إنشاء العروض والصفحات القابلة للطباعة.
• المعادلات الرياضية وإخفاء أجزاء الصور للمذاكرة.
• التحكم في الألوان والظلال والأحجام والمسافات.
• ربط العناصر، عكس الأسهم، وإنشاء مسارات منظمة.
• إضافة الروابط والملفات وملاحظات Obsidian داخل الرسم.

وإذا أضفت سكربتًا جديدًا لاحقًا، يستطيع النظام اكتشافه وتشغيله دون تعديل الخادم.

هذا العمل مبني ليتكامل مع مشروع Excalidraw for Obsidian من @zsviczian، ويستفيد من مكتبة السكربتات المعروفة للمشروع.

المشاريع والإضافات المستخدمة

النتيجة الموجودة هنا تعتمد على هذه المشاريع، ولكل واحد منها دور مهم:

• Obsidian — البرنامج الذي تُحفظ داخله الملاحظات والرسومات.
• Excalidraw for Obsidian من @zsviczian — إضافة الرسم الأساسية ومحرك تشغيل السكربتات.
• Excalidraw Extras من @zsviczian — يضيف ميزات الرسم المتقدمة مثل Mermaid والمعادلات.
• مكتبة سكربتات Excalidraw — مصدر السكربتات المعروفة التي توسّع إمكانات الرسم والتنظيم.
• Excalidraw — محرك الرسم المفتوح الذي تقوم عليه التجربة.
• mcp_excalidraw من @yctimlin — المشروع المرجعي الذي بُني عليه توافق أدوات MCP.

هذا المشروع يجمع هذه الأجزاء ويجهّزها لتعمل مع Claude وCodex بطريقة أبسط، ولا ينسب تطويرها الأصلي لنفسه.

ماذا يستطيع أن يفعل؟

• كتابة الملاحظات وتنظيمها والبحث فيها.
• إنشاء رسومات Excalidraw وتعديلها وحفظها.
• تشغيل السكربتات على الرسم المفتوح.
• إنشاء خرائط ذهنية ومخططات عمل ورسومات شرح.
• إضافة الصور والروابط والمعادلات والملاحظات داخل الرسم.
• استخدام مكتبة العناصر وإعادة استعمال المكونات.
• تصدير الرسم بصيغة PNG أو SVG.
• مراجعة ترتيب الرسم قبل تسليمه.

أسهل طريقة على Windows

1. ثبّت Obsidian وأنشئ خزنة وافتحها مرة واحدة.
2. نزّل المشروع من Code ثم Download ZIP وفك الضغط عنه.
3. افتح المجلد واضغط مرتين على setup-windows.cmd.
4. اختر مجلد خزنة Obsidian من النافذة، وانتظر ظهور رسالة النجاح.
5. أغلق وافتح Obsidian وClaude أو Codex مرة واحدة.

هذا كل شيء. لا تحتاج إلى كتابة مسارات أو تعديل ملفات إعدادات. وإذا كان Node.js غير موجود، يسألك الملف أولًا ثم يثبّت نسخته الرسمية المستقرة باستخدام Windows Package Manager. لا يحدث أي تثبيت دون موافقتك.

الاستخدام بالأوامر

استخدم هذا القسم فقط إذا كنت تفضّل الطرفية أو تعمل على macOS أو Linux.

1. جهّز البرامج

ثبّت:

• Obsidian
• Node.js إصدار 18 أو أحدث

بعدها أنشئ خزنة Obsidian وافتحها مرة واحدة. على Windows يمكنك تجاوز بقية الأوامر واستخدام setup-windows.cmd كما في الأعلى.

2. حمّل المشروع

git clone https://github.com/azgem102-max/obsidian-excalidraw-universal-mcp.git
cd obsidian-excalidraw-universal-mcp

يمكنك أيضًا تنزيله من زر Code ثم Download ZIP في GitHub.

إذا كان Claude يعمل من خلال WSL، احفظ المشروع والخزنة على قرص Windows مثل C:. المثبّت يتعرف على WSL ويضع مسارات Windows الصحيحة داخل Claude Desktop تلقائيًا، ولن يكتب له مسارات Linux غير صالحة.

3. شغّل المثبّت

على Windows:

node install.mjs --vault "C:\مسار\خزنة Obsidian" --clients all --project-root "."

إذا كان المساعد يعمل في جلسة Linux منفصلة ولا يستطيع الوصول إلى إعدادات Windows، شغّل setup-windows.cmd من مجلد المشروع على Windows. ويمكن أيضًا استخدام الأمر التالي:

.\install-on-windows.ps1 -Clients "claude-desktop"

على macOS أو Linux:

node install.mjs --vault "$HOME/Documents/Obsidian Vault" --clients all --project-root "."

المثبّت يضيف Excalidraw وملحقاته والسكربتات، ثم يجهّز الاتصال مع Claude وCodex دون حذف إعداداتك الحالية.

إذا منعت صلاحيات Claude الوصول إلى إعدادات Windows، سيعرض المثبّت أمرًا جاهزًا لتشغيله مرة واحدة في Windows PowerShell بدل ترك إعداد ناقص.

4. أعد التشغيل

أغلق وافتح من جديد:

• Obsidian
• Claude أو Codex أو البرنامج الذي ستستخدمه

ثم افتح أي رسم Excalidraw داخل Obsidian.

5. تأكد أن كل شيء جاهز

node doctor.mjs --vault "C:\مسار\خزنة Obsidian"

إذا ظهرت عبارة جاهز للاستخدام فقد انتهيت.

الطريقة الأسهل: اترك الذكاء الاصطناعي يجهّزه

بعد تنزيل المشروع، افتح Claude أو Codex داخل مجلد المشروع وأرسل له:

اقرأ AGENTS.md وSTART-HERE-AR.md. جهّز Obsidian وExcalidraw على هذا الجهاز، شغّل المثبّت لخزنتي، ثم اطلب مني إعادة التشغيل وبعدها شغّل فحص الجاهزية.

سيقرأ المساعد التعليمات الموجودة في المشروع وينفذ الإعداد خطوة بخطوة.

الخط العربي

الخطوط المدفوعة أو الخاصة لا تُنشر داخل المشروع. إذا كنت تملك خطًا عربيًا بصيغة WOFF2، أضفه أثناء التثبيت:

node install.mjs --vault "C:\مسار\الخزنة" --clients all --font "C:\مسار\الخط.woff2"

إذا احتجت تفاصيل أكثر

• ابدأ من هنا
• دليل السكربتات
• الاستخدام مع الذكاء الاصطناعي
• حل المشكلات

المشروع تطوير مستقل وليس إصدارًا رسميًا من فريق Excalidraw. تراخيص المصادر مذكورة في إشعارات الطرف الثالث.