Obsidian وExcalidraw مع Claude وCodex

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

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

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

اختر دليلك قبل التثبيت

• Codex أو ChatGPT محلي يدعم MCP: دليل Codex وChatGPT

• Claude Desktop أو Claude Code: دليل Claude

لا تخلط الخطوات: Claude Desktop يحتاج تفعيل موصل excalidraw بعد التثبيت، أما Codex وClaude Code فلا يحتاجان هذا الزر.

Related MCP server: obsidian-local-rest-api

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

المشروع لا يكتفي برسم المربعات والأسهم. يستطيع تشغيل سكربتات 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. افتح أي رسم Excalidraw داخل Obsidian مرة واحدة.

6. أغلق وافتح Claude أو Codex مرة واحدة.

7. Claude Desktop فقط: فعّل موصل excalidraw من قائمة الموصلات.

هذا كل شيء. لا تحتاج إلى كتابة مسارات أو تعديل ملفات إعدادات. وإذا كان 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"

معيار النجاح هو السطر الأخير الذي يطبعه الطبيب، وهو ثابت لا يتغيّر بتغيّر اللغة:

RESULT install=ready bridge=ok client=registered ready=true

install=ready يعني التثبيت مكتمل، وbridge=ok يعني الجسر حيّ. وأي قيمة أخرى لـbridge لها معنى خاص — لا تفترض أن Obsidian مغلق: الطبيب يطبع المعنى والخطوة التالية سطرين بعد النتيجة. وجدول الحالات الخمس في START-HERE-AR.md.

للقراءة برمجيًا: node doctor.mjs --vault "<path>" --json وفيه ready و bridge.meaning وbridge.nextAction وbridge.blame.

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

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

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

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

الخط العربي

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

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

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

• ابدأ من هنا

• تثبيت Codex وChatGPT

• تثبيت Claude Desktop وClaude Code

• دليل السكربتات

• الاستخدام مع الذكاء الاصطناعي

• حل المشكلات

• مخطط دورة عمل الوكيل

• مخطط أين تنكسر السلسلة

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