MCP Blender

מה זה

BlenderMCP (ahujasid/blender-mcp) הוא פרויקט קוד פתוח של Siddharth Ahuja (@sidahuj) שמחבר את Blender ל-Claude AI דרך ה-Model Context Protocol. הוא בנוי כגשר דו-חלקי: MCP server שמריצים דרך uvx, ו-addon ל-Blender שפותח socket בצד Blender. הלקוח — Claude Desktop, אבל גם Cursor, VS Code ו-OpenCode — הופך לקופיילוט בתוך קובץ ה-.blend שלך: הוא יכול ליצור גאומטריה, להחיל חומרים, להריץ Python שרירותי ב-Blender, לשלוף אסטים מ-Poly Haven ו-Sketchfab, ולקרוא ל-Hyper3D Rodin או Hunyuan3D כדי לייצר מודלי 3D חדשים לגמרי מפרומפט. הפרויקט הוא MIT-licensed; הגרסה הנוכחית לפי pyproject.toml היא 1.6.0. חשוב לסייג: זהו integration של צד שלישי, לא מוצר רשמי של Blender (ראו בהמשך על השרת הרשמי החדש).

ארכיטקטורה

Claude Desktop ──MCP──> blender-mcp (uvx, on your machine)
                            │
                            │  TCP socket (default 9876)
                            ▼
                   Blender + addon.py (3D View > "Connect to Claude")

ה-addon רושם פאנל MCP-aware בסרגל הצד של 3D View ב-Blender; לחיצה על "Connect to Claude" פותחת את ה-socket המקומי שאליו ה-MCP server מתחבר. שני משתני סביבה מכווננים את החיבור: BLENDER_HOST (ברירת מחדל localhost) מאפשר לכוון את ה-MCP server ל-Blender שרץ בתהליך או קונטיינר אחר, ו-BLENDER_PORT (ברירת מחדל 9876) מחליף את הפורט כש-9876 תפוס. בתהליך עבודה עם Docker בדרך כלל מגדירים BLENDER_HOST=host.docker.internal.

פרוטוקול התקשורת הוא JSON פשוט מעל TCP: פקודות הן {type, params}, תגובות הן {status, result|message}. כלומר, אפשר לפנות ל-addon ישירות מ-Python REPL או מ-shell script לצורך דיבוג בלי לעבור דרך ה-LLM — שימושי כשמשהו לא מתנהג כשורה וצריך לבודד מאיזה צד נפלה הקריאה.

התקנה

דרישות מוקדמות: Blender 3.0+, Python 3.10+, מנהל החבילות uv.

# Install uv — macOS (README recommends Homebrew)
brew install uv
# or, cross-platform one-liner:
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install the addon
# 1. Download addon.py from github.com/ahujasid/blender-mcp
# 2. In Blender: Edit → Preferences → Add-ons → Install...
# 3. Pick the downloaded addon.py
# 4. Enable the "Interface: Blender MCP" checkbox
# 5. In the 3D View sidebar, click "Connect to Claude"

הגדרת Claude Desktop

הוסף ל-~/Library/Application Support/Claude/claude_desktop_config.json (macOS) — או לנתיב המקביל ב-Windows או Linux:

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

הפעל מחדש את Claude Desktop. קבוצת "tool" חדשה מופיעה בסרגל הכלים של הצ'אט: BlenderMCP.

מה Claude יכול לעשות לאחר התחברות

• יצירה, מחיקה ועריכה של צורות — primitives, transforms, parenting, modifiers.
• החלה או יצירה של חומרים — nodes, הגדרות principled BSDF, טעינת טקסטורות.
• הרצת Python שרירותי ב-Blender — הכלי execute_blender_code חושף את כל משטח ה-API של bpy; זהו ה-escape hatch שדרכו כל יכולת שאין לה כלי ייעודי עדיין מתאפשרת.
• בחינת הסצנה — מה נמצא ב-outliner, כיצד נראה כל אובייקט, אילו חומרים מחוברים.
• Poly Haven — “Download the right models, assets and HDRIs through Poly Haven.”
• Sketchfab — חיפוש והורדת מודלים מספריית Sketchfab (נוסף בגרסה 1.5.x).
• Hyper3D Rodin — יצירת מודלי 3D חדשים לגמרי מפרומפט טקסטואלי והוספתם לסצנה הפעילה.
• Hunyuan3D — מודל text-to-3D של Tencent, נתמך לצד Rodin.
• צילומי מסך של ה-viewport — Claude יכול לצלם snapshot של ה-3D viewport כדי להבין את מצב הסצנה הנוכחי.

דוגמאות שימוש

# In a Claude Desktop chat once BlenderMCP is connected:

"Make me a low-poly desk scene: a wooden desk,
 a monitor, a coffee mug. Apply a wood material to the desk
 and a matte black plastic to the monitor."

"Download a Poly Haven HDRI for an overcast outdoor scene
 and use it as world lighting."

"Use Hyper3D Rodin to generate a model of a vintage Polaroid
 camera, then place it on the desk facing the monitor."

"Render the current view at 1920x1080 with 128 samples and
 save to /tmp/desk-render.png."

כמה תבניות פרומפט שמתרגמות טוב לעבודה יומיומית, ומה מאחורי כל אחת מהן:

• “Create a low-poly scene in a dungeon, with a dragon guarding a pot of gold” — אחד מפרומפטי הדמו ב-README, ועובד בדיוק כמו שכתוב. קריאת Hyper3D Rodin מחזירה mesh שמיש של דרקון בפחות מדקה; הסרטון של ahujasid ב-YouTube מכיל את הקליפ המלא.
• “Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven” — ה-API של Poly Haven נותן ל-Claude שמי HDRI, טקסטורות קרקע ומודלי prop במעבר אחד.
• “Get information about the current scene, and make a threejs sketch from it” — בחינת סצנה → ייצוא → יצירת קוד, הכל בשיחה אחת.
• “Reference image attached — build a Blender scene that matches it” — עובד כי כלי צילום המסך של ה-viewport נותן ל-Claude אות משוב שהוא יכול להשוות לתמונת הקלט.

למה זה חשוב בפועל

בשימוש יומיומי, ההבדל מורגש מיד. רוב הדמואים של "AI ב-Blender" הם צילומי מסך מצ'אטבוט שקורא snippet של Python שאתה אז מדביק ידנית. BlenderMCP סוגר את הלולאה הזאת — Claude מריץ קריאות bpy על הקובץ האמיתי שלך, רואה מה הוא יצר, ומבצע איטרציה. השילוב של בחינת סצנה + Python שרירותי + צילומי מסך של viewport הופך "בנה לי את הסצנה הזאת" לפרומפט אחד, לא לטוטוריאל.

לולאת המשוב ההדוקה היא החלק שמשנה את תהליך העבודה באמת. Claude מציע סקריפט, מריץ אותו, מבקש צילום מסך של ה-viewport, רואה שחומר העץ נראה כקרטון, מחליף את ה-roughness, מרנדר שוב, ממשיך. אף דבר מזה אינו חדש תיאורטית — bpy תמיד היה שם — אבל ההבדל בין "העתק את ה-snippet הזה בן 40 השורות לטאב הסקריפטינג" ובין "אנא הכהה את עץ השולחן ונסה שוב" הוא ההבדל בין טוטוריאל לכלי.

לעניין שליפת אסטים, השילוב של Poly Haven + Sketchfab + Hyper3D Rodin אומר ש-Claude כמעט שלא נאלץ לנסות primitives פרוצדורליים כשרוצים משהו ספציפי. "הנח ספה ישנה מעור על הרצפה" — Sketchfab; "השתמש ב-HDRI של יום מעונן" — Poly Haven; "מצלמת Polaroid וינטג'" — Rodin. המודל בוחר את המקור הנכון בהתאם לשאלה אם ביקשת אסט ייחוס מהעולם האמיתי או אסט חדש שנוצר.

בטיחות ומגבלות

שלושה דברים שחשוב לזכור לפני שמפנים LLM לקובץ .blend שחשוב לך:

• Python שרירותי הוא Python שרירותי. הכלי execute_blender_code יכול להריץ כל דבר ש-bpy חושף — כולל כתיבה לפיילסיסטם, modal operators שמקפיאים את ה-UI, ושינויים שקשה לבטל. שמור לפני כל פרומפט לא טריוויאלי.
• MCP server אחד בכל פעם. ה-README מפורש בנושא: אל תריץ את BlenderMCP מ-Claude Desktop ו-Cursor בו-זמנית. ה-socket על פורט 9876 הוא single-client, ושני לקוחות שנלחמים עליו לא מייצרים שום דבר שימושי.
• הורדות Poly Haven נספרות. אסטים מ-Poly Haven נשלפים לדיסק בכל בקשה. כבה את התיבה ב-N-panel של Blender כשאינך רוצה תעבורת רשת, ו-Claude יעקוף את זה.

BlenderMCP גם אוסף טלמטריה. כשההסכמה פעילה, הנתונים הנאספים הם prompts, code snippets ו-screenshots אנונימיים — כלומר עצם תוכן העבודה שלך. למי שעובד על קובץ רגיש זה לא זניח. אפשר לבטל מהעדפות ה-addon ב-Blender, או על-ידי הרצה עם DISABLE_TELEMETRY=true uvx blender-mcp — ה-README מתעד את שני הנתיבים.

השרת הרשמי של Blender Foundation

השינוי הגדול ב-2026: ל-Blender יש עכשיו שרת MCP רשמי. ב-29 באפריל 2026 Anthropic הצטרפה כ-Corporate Patron ל-Development Fund של Blender בתרומה ראשונית של 240,000 אירו לשנה — פחות או יותר משכורות של ארבעה מפתחי Blender במשרה מלאה — שיועדה לליבת Blender ובפרט ל-Python API (התרומה דווחה מאוחר יותר כ-one-off ולא כהתחייבות שנתית). מתוך עבודת ה-Blender Lab יצא שרת MCP שמחבר את מודלי Claude ל-Blender ומאפשר לנתח ולדבג סצנות שלמות, או לבנות סקריפטים שמחילים שינויים על אובייקטים ב-batch. הוא זמין כבר היום ל-Blender 5.1, ומכיוון שהוא בנוי על MCP — הוא לא נעול ל-Claude אלא עובד עם כל LLM שמדבר את הפרוטוקול. ארכיטקטונית הוא מקביל ל-BlenderMCP: add-on שרץ בתוך Blender ומבצע בקשות, ו-MCP server נפרד שהלקוח משגר. ההבדל הפרקטי הוא הדגש — השרת הרשמי שם לנגד עיניו ניתוח, דיבוג ושינויים מסיביים על-בסיס ה-Python API, פחות יצירת אסטים מתוך פרומפט. שווה לעקוב: מקור ב-projects.blender.org/lab/blender_mcp, תיעוד ב-blender.org/lab/mcp-server.

שרתים חלופיים נוספים

לחלל Blender + MCP יש כבר כמה ממושים. שני שדרוגים שימושיים מעבר ל-ahujasid ולשרת הרשמי:

• djeada/blender-mcp-server — אלטרנטיבה אופינייטד עם דגש על בטיחות. ה-README מציין 22 כלים ב-6 namespaces, והתיעוד המפורט מונה 27 כלים ב-7 namespaces: בחינת סצנה, מניפולציה על אובייקטים, חומרים, רינדור/ייצוא, היסטוריה, הרצת Python, וניהול עבודות. הוא מוסיף בקרות שחסרות ב-ahujasid: Safe Mode שמגביל קלט/פלט של קבצים לתיקיית הפרויקט בלבד, whitelist לכלים, הגבלת script_path לתיקיות מאושרות, undo אוטומטי לפני כל mutation, ו-blocklist למודולים (subprocess, shutil, socket, webbrowser, ctypes, multiprocessing חסומים כברירת מחדל).
• dhakalnirajan/blender-open-mcp — fork המחווט למודלי Ollama מקומיים במקום LLMs בענן. הבחירה הנכונה כשאינך יכול או אינך רוצה לשלוח תוכן .blend ל-API של צד שלישי.

מקור

ריפו: github.com/ahujasid/blender-mcp מאת Siddharth Ahuja (גרסה נוכחית 1.6.0 לפי pyproject.toml, עם תמיכה ב-Hunyuan3D, חיפוש Sketchfab, Poly Haven ו-Hyper3D Rodin; רישיון MIT). שרת רשמי של Blender Foundation: blender.org/lab/mcp-server (ל-Blender 5.1). ממושים חלופיים: djeada/blender-mcp-server (27 כלים ב-7 namespaces, עם Safe Mode ו-module blocklist), dhakalnirajan/blender-open-mcp (Ollama מקומי).