feat: BPY MCP - Blender + OpenVINO SmolVLM/SmolLM3

- bpy 5.0.2 Blender Python API
- OpenVINO INT4 for CPU inference
- SmolVLM for image understanding
- SmolLM3 for text generation
- Gradio 6.0.2 MCP Server

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

README.md

@@ -0,0 +1,49 @@
+---
+title: BPY MCP
+emoji: 🎨
+colorFrom: yellow
+colorTo: purple
+sdk: gradio
+sdk_version: 6.0.2
+python_version: "3.11"
+app_file: app.py
+pinned: false
+license: mit
+tags:
+  - mcp-server-track
+  - blender
+  - bpy
+  - openvino
+  - cpu
+  - 3d
+short_description: "Blender Python API with OpenVINO SmolVLM/SmolLM3 - CPU only"
+---
+
+# 🎨 BPY MCP Server
+
+**Blender Python API + OpenVINO AI** - CPU-only 3D generation
+
+## Features
+
+- **bpy 5.0.2** - Blender Python API
+- **OpenVINO INT4** - Fast CPU inference
+- **SmolVLM** - Vision-Language (image understanding)
+- **SmolLM3** - Text generation (scene descriptions)
+- **MCP Server** - Tool integration
+
+## Models
+
+- `dev-bjoern/smolvlm-int4-ov` - Image-to-Text
+- `dev-bjoern/smollm3-int4-ov` - Text Generation
+
+## MCP Integration
+
+```json
+{
+  "mcpServers": {
+    "bpy-mcp": {
+      "url": "https://dev-bjoern-bpy-mcp.hf.space/gradio_api/mcp/sse"
+    }
+  }
+}
+```

app.py

@@ -0,0 +1,276 @@
+"""
+BPY MCP Server - Blender Python API with OpenVINO SmolVLM/SmolLM3
+CPU-only 3D generation
+"""
+import os
+import tempfile
+import uuid
+from pathlib import Path
+from typing import Optional
+
+import gradio as gr
+import numpy as np
+from huggingface_hub import snapshot_download
+
+# OpenVINO imports
+import openvino_genai as ov_genai
+
+# Blender Python API
+import bpy
+
+# Global models
+SMOLVLM_PIPE = None
+SMOLLM3_PIPE = None
+
+
+def load_smolvlm():
+    """Load SmolVLM OpenVINO model for image understanding"""
+    global SMOLVLM_PIPE
+
+    if SMOLVLM_PIPE is not None:
+        return SMOLVLM_PIPE
+
+    print("Loading SmolVLM INT4 OpenVINO...")
+    model_path = snapshot_download("dev-bjoern/smolvlm-int4-ov")
+    SMOLVLM_PIPE = ov_genai.VLMPipeline(model_path, device="CPU")
+    print("SmolVLM loaded")
+    return SMOLVLM_PIPE
+
+
+def load_smollm3():
+    """Load SmolLM3 OpenVINO model for text generation"""
+    global SMOLLM3_PIPE
+
+    if SMOLLM3_PIPE is not None:
+        return SMOLLM3_PIPE
+
+    print("Loading SmolLM3 INT4 OpenVINO...")
+    model_path = snapshot_download("dev-bjoern/smollm3-int4-ov")
+    SMOLLM3_PIPE = ov_genai.LLMPipeline(model_path, device="CPU")
+    print("SmolLM3 loaded")
+    return SMOLLM3_PIPE
+
+
+def analyze_image(image: np.ndarray, prompt: str = "Describe this image for 3D scene creation") -> str:
+    """Analyze image with SmolVLM"""
+    if image is None:
+        return "No image provided"
+
+    try:
+        pipe = load_smolvlm()
+
+        # Convert to PIL
+        if isinstance(image, np.ndarray):
+            pil_image = Image.fromarray(image)
+        else:
+            pil_image = image
+
+        # Generate description
+        result = pipe.generate(
+            prompt,
+            image=pil_image,
+            max_new_tokens=256
+        )
+
+        return result
+    except Exception as e:
+        return f"Error: {e}"
+
+
+def generate_scene_description(scene_type: str, style: str = "realistic") -> str:
+    """Generate scene description with SmolLM3"""
+    try:
+        pipe = load_smollm3()
+
+        prompt = f"Create a detailed description for a {style} {scene_type} 3D scene. Include objects, materials, lighting, and camera position."
+
+        result = pipe.generate(
+            prompt,
+            max_new_tokens=512
+        )
+
+        return result
+    except Exception as e:
+        return f"Error: {e}"
+
+
+def create_primitive(primitive_type: str, name: str = "Object", location: tuple = (0, 0, 0)) -> str:
+    """Create a Blender primitive object"""
+    try:
+        # Clear existing objects
+        bpy.ops.object.select_all(action='SELECT')
+        bpy.ops.object.delete()
+
+        # Create primitive
+        if primitive_type == "cube":
+            bpy.ops.mesh.primitive_cube_add(location=location)
+        elif primitive_type == "sphere":
+            bpy.ops.mesh.primitive_uv_sphere_add(location=location)
+        elif primitive_type == "cylinder":
+            bpy.ops.mesh.primitive_cylinder_add(location=location)
+        elif primitive_type == "cone":
+            bpy.ops.mesh.primitive_cone_add(location=location)
+        elif primitive_type == "torus":
+            bpy.ops.mesh.primitive_torus_add(location=location)
+        elif primitive_type == "plane":
+            bpy.ops.mesh.primitive_plane_add(location=location)
+        elif primitive_type == "monkey":
+            bpy.ops.mesh.primitive_monkey_add(location=location)
+        else:
+            return f"Unknown primitive: {primitive_type}"
+
+        # Rename object
+        obj = bpy.context.active_object
+        obj.name = name
+
+        # Export to GLB
+        output_dir = tempfile.mkdtemp()
+        glb_path = f"{output_dir}/{name}_{uuid.uuid4().hex[:8]}.glb"
+
+        bpy.ops.export_scene.gltf(
+            filepath=glb_path,
+            export_format='GLB'
+        )
+
+        return glb_path
+    except Exception as e:
+        return f"Error: {e}"
+
+
+def create_scene_from_description(description: str) -> str:
+    """Create a simple scene based on AI description"""
+    try:
+        # Clear scene
+        bpy.ops.object.select_all(action='SELECT')
+        bpy.ops.object.delete()
+
+        # Parse description for keywords and create objects
+        desc_lower = description.lower()
+
+        # Add ground plane
+        bpy.ops.mesh.primitive_plane_add(size=10, location=(0, 0, 0))
+        ground = bpy.context.active_object
+        ground.name = "Ground"
+
+        # Add objects based on keywords
+        if "cube" in desc_lower or "box" in desc_lower:
+            bpy.ops.mesh.primitive_cube_add(location=(0, 0, 1))
+            bpy.context.active_object.name = "Cube"
+
+        if "sphere" in desc_lower or "ball" in desc_lower:
+            bpy.ops.mesh.primitive_uv_sphere_add(location=(2, 0, 1))
+            bpy.context.active_object.name = "Sphere"
+
+        if "cylinder" in desc_lower or "pillar" in desc_lower:
+            bpy.ops.mesh.primitive_cylinder_add(location=(-2, 0, 1))
+            bpy.context.active_object.name = "Cylinder"
+
+        # Add camera
+        bpy.ops.object.camera_add(location=(7, -7, 5))
+        camera = bpy.context.active_object
+        camera.rotation_euler = (1.1, 0, 0.8)
+        bpy.context.scene.camera = camera
+
+        # Add light
+        bpy.ops.object.light_add(type='SUN', location=(5, 5, 10))
+
+        # Export
+        output_dir = tempfile.mkdtemp()
+        glb_path = f"{output_dir}/scene_{uuid.uuid4().hex[:8]}.glb"
+
+        bpy.ops.export_scene.gltf(
+            filepath=glb_path,
+            export_format='GLB'
+        )
+
+        return glb_path
+    except Exception as e:
+        return f"Error: {e}"
+
+
+# Gradio Interface
+with gr.Blocks(title="BPY MCP") as demo:
+    gr.Markdown("""
+    # 🎨 BPY MCP Server
+    **Blender Python API + OpenVINO AI** - CPU-only
+
+    Using SmolVLM for image understanding and SmolLM3 for text generation
+    """)
+
+    with gr.Tab("Image Analysis (SmolVLM)"):
+        with gr.Row():
+            with gr.Column():
+                img_input = gr.Image(label="Input Image", type="numpy")
+                img_prompt = gr.Textbox(
+                    label="Prompt",
+                    value="Describe this image for 3D scene creation"
+                )
+                img_btn = gr.Button("🔍 Analyze", variant="primary")
+            with gr.Column():
+                img_output = gr.Textbox(label="Description", lines=10)
+
+        img_btn.click(analyze_image, [img_input, img_prompt], img_output)
+
+    with gr.Tab("Scene Generator (SmolLM3)"):
+        with gr.Row():
+            with gr.Column():
+                scene_type = gr.Dropdown(
+                    ["forest", "desert", "city", "interior", "space", "underwater"],
+                    label="Scene Type",
+                    value="forest"
+                )
+                scene_style = gr.Dropdown(
+                    ["realistic", "stylized", "low-poly", "fantasy"],
+                    label="Style",
+                    value="realistic"
+                )
+                scene_btn = gr.Button("📝 Generate Description", variant="primary")
+            with gr.Column():
+                scene_desc = gr.Textbox(label="Scene Description", lines=10)
+
+        scene_btn.click(generate_scene_description, [scene_type, scene_style], scene_desc)
+
+        with gr.Row():
+            create_btn = gr.Button("🎬 Create 3D Scene from Description", variant="secondary")
+            scene_model = gr.Model3D(label="3D Scene")
+
+        create_btn.click(create_scene_from_description, scene_desc, scene_model)
+
+    with gr.Tab("Primitives"):
+        with gr.Row():
+            with gr.Column():
+                prim_type = gr.Dropdown(
+                    ["cube", "sphere", "cylinder", "cone", "torus", "plane", "monkey"],
+                    label="Primitive Type",
+                    value="cube"
+                )
+                prim_name = gr.Textbox(label="Name", value="MyObject")
+                prim_btn = gr.Button("🔲 Create Primitive", variant="primary")
+            with gr.Column():
+                prim_model = gr.Model3D(label="3D Preview")
+                prim_file = gr.File(label="Download GLB")
+
+        prim_btn.click(create_primitive, [prim_type, prim_name], prim_model)
+        prim_model.change(lambda x: x, inputs=[prim_model], outputs=[prim_file])
+
+    gr.Markdown("""
+    ---
+    ### MCP Server
+    ```json
+    {
+      "mcpServers": {
+        "bpy-mcp": {
+          "url": "https://dev-bjoern-bpy-mcp.hf.space/gradio_api/mcp/sse"
+        }
+      }
+    }
+    ```
+
+    ### Models
+    - **SmolVLM**: `dev-bjoern/smolvlm-int4-ov` (Image-to-Text)
+    - **SmolLM3**: `dev-bjoern/smollm3-int4-ov` (Text Generation)
+    """)
+
+
+if __name__ == "__main__":
+    demo.launch(server_name="0.0.0.0", server_port=7860, mcp_server=True)

requirements.txt

@@ -0,0 +1,8 @@
+bpy==5.0.2
+gradio>=5.0.0
+openvino>=2025.0.0
+openvino-genai>=2025.0.0
+optimum[openvino]>=1.20.0
+transformers>=4.45.0
+huggingface_hub>=0.26.0
+numpy>=1.26.0