Vibr MCP

Vibr MCP خادم صغير تشغّله على جهاز الكمبيوتر الخاص بك. يتيح لوكيل مثل Claude Code أو Cursor أو Claude Desktop العمل مع Vibr: عرض نماذجك الأولية، وبناء الشاشات وتعديلها، واستيراد ملف Figma، وقراءة سماتك كرموز تصميم (design tokens)، وتصدير نموذج أولي إلى مشروعك.

توجد مكتبتك ومفاتيحك في متصفحك، لذا يجري العمل في علامة تبويب Vibr تقوم بتوصيلها. يطلب الوكيل، وتنجز علامة التبويب العمل باستخدام نظام التصميم الخاص بك ومفتاح نموذجك، تمامًا كما يحدث عندما تكتب طلبًا بنفسك.

الإعداد

تحتاج إلى Node 20 أو أحدث. في Claude Code، أضف الخادم مرة واحدة:

claude mcp add vibr -- npx -y vibr-mcp

ويقبل عملاء MCP الآخرون الأمر نفسه في ملف إعداداتهم:

{ "mcpServers": { "vibr": { "command": "npx", "args": ["-y", "vibr-mcp"] } } }

وصّل علامة تبويب

1. اطلب من وكيلك الاتصال بـ Vibr. سيعطيك رابطًا إلى صفحة يعرضها الخادم على جهازك أنت.
2. افتح الرابط في المتصفح الذي تستخدم فيه Vibr، واختر Open Vibr. يُفتح Vibr في نافذة خاصة به، مع مكتبتك ومفتاحك. إذا لم يكن لدى Vibr مفتاح بعد، فأضف مفتاحًا هناك.
3. يسألك Vibr عمّا إذا كان يُسمح لـ MCP على هذا الجهاز بالعمل في تلك النافذة. اختر السماح.
4. تعرض النافذة ‏MCP متصل في الأسفل. اختر قطع الاتصال لإنهاء الاتصال في أي وقت.

أبقِ صفحة الخادم ونافذة Vibr مفتوحتين أثناء عمل الوكيل. يصلح كل رابط لجلسة واحدة من الخادم؛ وعند إعادة تشغيل الخادم، اطلب رابطًا جديدًا.

ما الذي يمكنه فعله

• العرض والقراءة. نماذجك الأولية المحفوظة، والتعليمات البرمجية لنموذج أولي وطلباته، والإشارات المتاحة في مكتبتك، وإعدادات علامة التبويب (المزوّد والنموذج ونظام التصميم، وليس مفتاحك أبدًا).
• البناء. تمرير طلب عبر التخطيط والبناء والتحقق والمراجعة والإصلاح، كنموذج أولي جديد أو كنسخة معدّلة من نموذج موجود، وحفظه في مكتبتك. يستخدم مفتاحك، لذا يكلّف ما يكلّفه الطلب نفسه في Vibr.
• الاستيراد من Figma. استيراد ملف .vibr-figma.json من إضافة Send to Vibr وبناء إطاراته كشاشات مرتبطة. راجع الاستيراد من Figma.
• قراءة السمات. سمة كخصائص CSS مخصصة أو رموز تصميم، مع أدوارها الفاتحة والداكنة.
• التصدير. كتابة نموذج أولي في مجلد كصفحة واحدة، أو تدفق مرتبط، أو شيفرة React المصدرية. لا يستبدل أي ملف أبدًا ما لم تطلب ذلك، ولا يكتب أبدًا خارج المجلد الذي تحدده.

الخصوصية والأمان

• لا تغادر مفاتيحك علامة التبويب أبدًا. لا يراها الخادم أبدًا، وتنتقل الطلبات من علامة التبويب إلى مزوّد النموذج كما هو الحال دائمًا.
• يستمع الخادم على 127.0.0.1 فقط. وهو يمرّر العمل إلى Vibr عبر صفحته الخاصة في متصفحك، لذا لا يتصل vibr.art بجهازك أبدًا.
• لا يقبل Vibr العمل إلا من الصفحة التي فتحته، وفقط مع الرمز العشوائي الذي يُستخدم مرة واحدة في رابط الخادم، وفقط بعد أن تختار السماح.
• يصل المحتوى من مكتبتك إلى الوكيل كبيانات: لا يمكن لنص نموذج أولي أو لملف مستورد أن يعطي وكيلك تعليمات ما لم يتعامل وكيلك معه على هذا النحو، لذا راجع ما يبنيه كما تراجع أي مسودة.

المزيد في المفاتيح والخصوصية والتخزين.

الإعدادات

• VIBR_MCP_PORT: المنفذ على جهازك (4517 ما لم يكن مشغولًا).
• VIBR_MCP_APP: صفحة Vibr التي يفتحها الرابط (https://vibr.art/ ما لم تشغّل Vibr بنفسك).

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

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