Excalidraw Architect MCP

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

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

تخطيط تلقائي — لا مكان يدوي
ممرات سباحة ومجموعات وتدفقات بأسلوب تسلسلي
إخراج Excalidraw .json (قابل للتحرير) وPNG (مع cairo اختياري)
مضاعف دقة قابل للتخصيص لـ PNG واضح
محلي — لا SaaS، لا telemetry

عرض مباشر

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

excalidraw-architect-mcp.replay ▶ جاهز

0/0

التثبيت

اختر العميل

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

{
  "mcpServers": {
    "excalidraw-architect-mcp": {
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}

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

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

{
  "mcpServers": {
    "excalidraw-architect-mcp": {
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "excalidraw-architect-mcp": {
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "excalidraw-architect-mcp": {
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "excalidraw-architect-mcp",
      "command": "uvx",
      "args": [
        "excalidraw-architect-mcp"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "excalidraw-architect-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "excalidraw-architect-mcp"
        ]
      }
    }
  }
}

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

claude mcp add excalidraw-architect-mcp -- uvx excalidraw-architect-mcp

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

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

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

توليد مخطط معماري لوثيقة تصميم

👤 المهندسون الذين يكتبون وثائق تصميم ⏱ ~10 min beginner

متى تستخدمه: وثيقة تصميمك تحتاج مخططًا للنظام ولا تريد قضاء ساعة في Excalidraw.

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

Excalidraw (ويب أو سطح مكتب) — excalidraw.com — الصق مخرج .json

الخطوات

الوصف

Generate an Excalidraw diagram: API gateway → auth service → user service & orders service → Postgres. Add a Redis cache between API and user service.✓ تم النسخ

→ Excalidraw .json مُعاد
التحسين

Add a sidecar logging agent on each service. Group services in a 'core' cluster.✓ تم النسخ

→ مخطط محدَّث مع مجموعة + sidecars
التصدير

Render to PNG at 3x and save to /docs/arch.png.✓ تم النسخ

→ PNG مكتوب

النتيجة: مخطط جاهز للوثيقة في دقيقتين بدلًا من 30.

المزالق

عدد كثير من العقد — المخطط يصبح غير مقروء — اطلب مجموعات ومستوى تجريد أعلى أولًا

اجمعها مع: filesystem

تصوير تدفق الاستدعاءات عبر قاعدة كود

👤 المهندسون الذين يراجعون كودًا غير مألوف ⏱ ~5 min beginner

متى تستخدمه: تتبّعت طلبًا — الآن تريد صورة.

الخطوات

صف ما رأيت

Diagram a request flow: HTTP handler → validator → service → repo → DB. Show validation error path branching off.✓ تم النسخ

→ مخطط بأسلوب تسلسلي

النتيجة: صورة تساوي 200 كلمة في وصف PR.

المزالق

ارتباك بين التسلسلي والمكوّناتي — كن واضحًا — 'sequence diagram' أو 'component diagram'

التركيبات

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

excalidraw-architect-mcp + filesystem

حفظ مخططات منسوخة جانب وثائق التصميم

Save the .excalidraw.json next to the doc and re-render to /docs/arch.png.✓ تم النسخ

excalidraw-architect-mcp + github

إرفاق مخططات بأوصاف PR

Generate the diagram and embed the PNG in PR #1234's description.✓ تم النسخ

الأدوات

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

الأداة	المدخلات	متى تستدعيها	التكلفة
generate_diagram	description, layout?	مخطط أولي من prompt	free
modify_diagram	json, instruction	تعديلات تكرارية	free
to_png	json, scale?	التضمين في وثيقة	free

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

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

حصة API: محلي — لا شيء
الرموز لكل استدعاء: 300–2000
التكلفة المالية: مجاني
نصيحة: كرّر عبر modify_diagram بدلًا من التوليد من الصفر

الأمان

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

الحد الأدنى من الصلاحيات: Local file write

تخزين بيانات الاعتماد: لا شيء

نقل البيانات الخارجي: لا شيء — محلي بالكامل

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

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

PNG export fails

ثبّت التبعية اختيارية cairo: pip install excalidraw-architect-mcp[png]

Layout looks crowded

اطلب تجميعًا بمجموعات أو مجموعة عقد أصغر

Excalidraw refuses to import

قد يكون JSON schema غير دقيق قليلًا؛ اطلب من Claude التحقق من أحدث schema لـ Excalidraw

البدائل