Vibr MCP

Vibr MCP הוא שרת קטן שמריצים על המחשב שלכם. הוא מאפשר לסוכן כמו Claude Code,‏ Cursor או Claude Desktop לעבוד עם Vibr: להציג את אבות הטיפוס שלכם, לבנות מסכים ולשנות אותם, לייבא קובץ Figma, לקרוא את ערכות הנושא שלכם כטוקנים של עיצוב, ולייצא אב טיפוס לפרויקט שלכם.

הספרייה והמפתחות שלכם נמצאים בדפדפן, ולכן העבודה מתבצעת בכרטיסיית 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: ההרצה מציגה כל שלב, בדיוק כמו כשאתם מקלידים בקשה.