@hybridlabor-api/aos 4.4.1 → 4.4.2-beta.1

package/mcps/blender-mcp-server/scripts/library/camera.py

@@ -1,51 +0,0 @@
-"""Create a camera, set it active, and optionally position it.
-
-Args:
-    name (str): Camera name. Default: "Camera"
-    location (list[float]): [x, y, z] location. Default: [7, -6, 5]
-    rotation (list[float]): [rx, ry, rz] Euler rotation in radians. Default: None
-    focal_length (float): Lens focal length in mm. Default: 50.0
-    set_active (bool): Make this the scene's active camera. Default: True
-    use_existing (str|None): Name of existing camera to configure instead. Default: None
-
-Result:
-    name (str): Camera object name
-    location (list[float]): Final location
-    focal_length (float): Focal length set
-    is_active (bool): Whether it is the active scene camera
-"""
-
-import bpy
-
-use_existing = args.get("use_existing")
-
-if use_existing:
-    cam_obj = bpy.data.objects.get(use_existing)
-    if not cam_obj:
-        raise ValueError(f"Camera '{use_existing}' not found")
-else:
-    cam_name = args.get("name", "Camera")
-    cam_data = bpy.data.cameras.new(cam_name)
-    cam_obj = bpy.data.objects.new(cam_name, cam_data)
-    bpy.context.collection.objects.link(cam_obj)
-
-location = args.get("location")
-if location:
-    cam_obj.location = tuple(location)
-
-rotation = args.get("rotation")
-if rotation:
-    cam_obj.rotation_euler = tuple(rotation)
-
-focal_length = args.get("focal_length", 50.0)
-cam_obj.data.lens = focal_length
-
-if args.get("set_active", True):
-    bpy.context.scene.camera = cam_obj
-
-__result__ = {
-    "name": cam_obj.name,
-    "location": list(cam_obj.location),
-    "focal_length": cam_obj.data.lens,
-    "is_active": bpy.context.scene.camera == cam_obj,
-}

package/mcps/blender-mcp-server/scripts/library/collections.py

@@ -1,65 +0,0 @@
-"""Create collections and move objects into them.
-
-Args:
-    collections (list[dict]): List of collection specs. Each dict:
-        - name (str): Collection name (required)
-        - objects (list[str]): Object names to move into the collection
-        - parent (str|None): Parent collection name. Default: scene collection
-        - color_tag (str|None): Color tag, e.g. "COLOR_01". Default: None
-
-Result:
-    created (list[str]): Collections created
-    moved (dict[str, list[str]]): Map of collection name to objects moved in
-    skipped (list[str]): Objects not found
-"""
-
-import bpy
-
-collections_spec = args.get("collections", [])
-created = []
-moved = {}
-skipped = []
-
-for spec in collections_spec:
-    col_name = spec.get("name")
-    if not col_name:
-        continue
-
-    # Create or get collection
-    col = bpy.data.collections.get(col_name)
-    if col is None:
-        col = bpy.data.collections.new(col_name)
-        parent_name = spec.get("parent")
-        if parent_name:
-            parent = bpy.data.collections.get(parent_name)
-            if parent:
-                parent.children.link(col)
-            else:
-                bpy.context.scene.collection.children.link(col)
-        else:
-            bpy.context.scene.collection.children.link(col)
-        created.append(col_name)
-
-    color_tag = spec.get("color_tag")
-    if color_tag:
-        col.color_tag = color_tag
-
-    moved[col_name] = []
-    for obj_name in spec.get("objects", []):
-        obj = bpy.data.objects.get(obj_name)
-        if obj is None:
-            skipped.append(obj_name)
-            continue
-
-        # Unlink from current collections
-        for existing_col in obj.users_collection:
-            existing_col.objects.unlink(obj)
-
-        col.objects.link(obj)
-        moved[col_name].append(obj_name)
-
-__result__ = {
-    "created": created,
-    "moved": moved,
-    "skipped": skipped,
-}

package/mcps/blender-mcp-server/scripts/library/create_mesh.py

@@ -1,41 +0,0 @@
-"""Create a primitive mesh object without using bpy.ops.
-
-Args:
-    name (str): Object name. Default: mesh type title-cased.
-    mesh_type (str): cube, sphere, cylinder, plane, cone, or torus. Default: cube
-    location (list[float]): [x, y, z] location. Default: [0, 0, 0]
-    size (float): Primitive size. Matches the MCP object.create_mesh size meaning.
-
-Result:
-    name (str): Created object name
-    type (str): Blender object type
-    location (list[float]): Object location
-
-Notes:
-    Prefer this script or the injected ``mcp_create_mesh(...)`` helper inside
-    python.execute scripts over ``bpy.ops.mesh.primitive_*_add``. The operator
-    path can trigger unstable view-layer updates in live bridge sessions,
-    especially around Mantaflow setup.
-"""
-
-name = args.get("name")
-mesh_type = args.get("mesh_type", "cube")
-location = args.get("location", [0, 0, 0])
-size = args.get("size", 2.0)
-
-helper = globals().get("mcp_create_mesh")
-if helper is None:
-    raise RuntimeError("mcp_create_mesh helper is unavailable in this execution context")
-
-obj = helper(
-    mesh_type,
-    name=name,
-    location=location,
-    size=size,
-)
-
-__result__ = {
-    "name": obj.name,
-    "type": obj.type,
-    "location": list(obj.location),
-}

package/mcps/blender-mcp-server/scripts/library/effector.py

@@ -1,48 +0,0 @@
-"""Set up collision/effector objects for fluid or physics simulations.
-
-Args:
-    objects (list[str]): Names of objects to configure as effectors.
-    effector_type (str): "COLLISION" for fluid effectors. Default: "COLLISION"
-    surface_distance (float): Surface thickness. Default: 0.01
-    use_effector (bool): Whether to also add physics collision. Default: True
-
-Result:
-    configured (list[str]): Objects successfully configured
-    skipped (list[str]): Objects not found
-"""
-
-import bpy
-
-obj_names = args.get("objects", [])
-effector_type = args.get("effector_type", "COLLISION")
-surface_distance = args.get("surface_distance", 0.01)
-use_effector = args.get("use_effector", True)
-
-configured = []
-skipped = []
-
-for name in obj_names:
-    obj = bpy.data.objects.get(name)
-    if obj is None:
-        skipped.append(name)
-        continue
-
-    fluid_mod = obj.modifiers.get("Fluid")
-    if fluid_mod is None:
-        fluid_mod = obj.modifiers.new(name="Fluid", type="FLUID")
-    fluid_mod.fluid_type = "EFFECTOR"
-    eff = fluid_mod.effector_settings
-    eff.effector_type = effector_type
-    eff.surface_distance = surface_distance
-
-    # Optionally add physics collision as well
-    if use_effector:
-        has_collision = any(m.type == "COLLISION" for m in obj.modifiers)
-        if not has_collision:
-            obj.modifiers.new(name="Collision", type="COLLISION")
-    configured.append(name)
-
-__result__ = {
-    "configured": configured,
-    "skipped": skipped,
-}

package/mcps/blender-mcp-server/scripts/library/fluid_domain.py

@@ -1,80 +0,0 @@
-"""Create a Mantaflow fluid domain.
-
-Args:
-    domain_name (str): Name for the domain object. Default: "FluidDomain"
-    location (list[float]): [x, y, z] location. Default: [0, 0, 2]
-    size (float): Cube size. Default: 4.0
-    resolution (int): Domain max resolution. Default: 64
-    cache_dir (str): Cache directory (Blender relative path OK). Default: "//fluid_cache"
-    domain_type (str): "LIQUID" or "GAS". Default: "LIQUID"
-    show_viewport (bool): Whether the fluid modifier is visible in the viewport. Default: False
-
-Result:
-    domain (str): Created object name
-    resolution (int): Resolution set
-    cache_dir (str): Cache directory set
-"""
-
-import bpy
-
-
-def create_cube_mesh(name: str, size: float):
-    half = size / 2.0
-    verts = [
-        (-half, -half, -half),
-        (half, -half, -half),
-        (half, half, -half),
-        (-half, half, -half),
-        (-half, -half, half),
-        (half, -half, half),
-        (half, half, half),
-        (-half, half, half),
-    ]
-    faces = [
-        (0, 1, 2, 3),
-        (4, 5, 6, 7),
-        (0, 1, 5, 4),
-        (1, 2, 6, 5),
-        (2, 3, 7, 6),
-        (3, 0, 4, 7),
-    ]
-    mesh = bpy.data.meshes.new(f"{name}Mesh")
-    mesh.from_pydata(verts, [], faces)
-    mesh.update()
-    obj = bpy.data.objects.new(name, mesh)
-    bpy.context.scene.collection.objects.link(obj)
-    return obj
-
-
-name = args.get("domain_name", "FluidDomain")
-location = args.get("location", [0, 0, 2])
-size = args.get("size", 4.0)
-resolution = args.get("resolution", 64)
-cache_dir = args.get("cache_dir", "//fluid_cache")
-domain_type = args.get("domain_type", "LIQUID")
-show_viewport = args.get("show_viewport", False)
-
-domain = create_cube_mesh(name, size)
-domain.location = tuple(location)
-
-modifier = domain.modifiers.get("Fluid")
-if modifier is None:
-    modifier = domain.modifiers.new(name="Fluid", type="FLUID")
-
-modifier.fluid_type = "DOMAIN"
-settings = modifier.domain_settings
-settings.domain_type = domain_type
-settings.resolution_max = resolution
-settings.cache_directory = cache_dir
-modifier.show_viewport = show_viewport
-
-# Make domain wireframe for visibility
-domain.display_type = "WIRE"
-
-__result__ = {
-    "domain": domain.name,
-    "resolution": settings.resolution_max,
-    "cache_dir": settings.cache_directory,
-    "domain_type": domain_type,
-    "show_viewport": modifier.show_viewport,
-}

package/mcps/blender-mcp-server/scripts/library/fluid_inflow.py

@@ -1,98 +0,0 @@
-"""Create or configure a fluid inflow source.
-
-Args:
-    name (str): Object name. Default: "FluidInflow"
-    location (list[float]): [x, y, z] location. Default: [0, 0, 3]
-    size (float): Cube size for new inflow object. Default: 1.0
-    use_existing (str|None): Name of existing object to convert. Default: None
-    flow_type (str): "LIQUID", "SMOKE", or "FIRE". Default: "LIQUID"
-    flow_behavior (str): "INFLOW", "OUTFLOW", or "GEOMETRY". Default: "INFLOW"
-    use_initial_velocity (bool): Enable initial velocity. Default: False
-    initial_velocity (list[float]): [vx, vy, vz]. Default: [0, 0, 0]
-    show_viewport (bool): Whether to evaluate the fluid modifier in the viewport. Default: False
-    hide_viewport (bool): Whether to hide the source object in the viewport. Default: True
-    hide_render (bool): Whether to hide the source object in renders. Default: True
-
-Result:
-    name (str): Object name
-    flow_type (str): Flow type set
-"""
-
-import bpy
-
-
-def create_cube_mesh(name: str, size: float):
-    half = size / 2.0
-    verts = [
-        (-half, -half, -half),
-        (half, -half, -half),
-        (half, half, -half),
-        (-half, half, -half),
-        (-half, -half, half),
-        (half, -half, half),
-        (half, half, half),
-        (-half, half, half),
-    ]
-    faces = [
-        (0, 1, 2, 3),
-        (4, 5, 6, 7),
-        (0, 1, 5, 4),
-        (1, 2, 6, 5),
-        (2, 3, 7, 6),
-        (3, 0, 4, 7),
-    ]
-    mesh = bpy.data.meshes.new(f"{name}Mesh")
-    mesh.from_pydata(verts, [], faces)
-    mesh.update()
-    obj = bpy.data.objects.new(name, mesh)
-    bpy.context.scene.collection.objects.link(obj)
-    return obj
-
-
-obj_name = args.get("name", "FluidInflow")
-use_existing = args.get("use_existing")
-
-if use_existing:
-    obj = bpy.data.objects.get(use_existing)
-    if not obj:
-        raise ValueError(f"Object '{use_existing}' not found")
-    bpy.context.view_layer.objects.active = obj
-else:
-    location = args.get("location", [0, 0, 3])
-    size = args.get("size", 1.0)
-    obj = create_cube_mesh(obj_name, size)
-    obj.location = tuple(location)
-    bpy.context.view_layer.objects.active = obj
-
-flow_type = args.get("flow_type", "LIQUID")
-flow_behavior = args.get("flow_behavior", "INFLOW")
-show_viewport = args.get("show_viewport", False)
-hide_viewport = args.get("hide_viewport", True)
-hide_render = args.get("hide_render", True)
-
-modifier = obj.modifiers.get("Fluid")
-if modifier is None:
-    modifier = obj.modifiers.new(name="Fluid", type="FLUID")
-
-modifier.fluid_type = "FLOW"
-modifier.show_viewport = show_viewport
-flow = modifier.flow_settings
-flow.flow_type = flow_type
-flow.flow_behavior = flow_behavior
-
-if args.get("use_initial_velocity", False):
-    flow.use_initial_velocity = True
-    vel = args.get("initial_velocity", [0, 0, 0])
-    flow.velocity_coord = tuple(vel)
-
-obj.hide_viewport = hide_viewport
-obj.hide_render = hide_render
-
-__result__ = {
-    "name": obj.name,
-    "flow_type": flow_type,
-    "flow_behavior": flow_behavior,
-    "show_viewport": modifier.show_viewport,
-    "hide_viewport": obj.hide_viewport,
-    "hide_render": obj.hide_render,
-}

package/mcps/blender-mcp-server/scripts/library/frame_range.py

@@ -1,35 +0,0 @@
-"""Set the scene frame range and optionally jump to a frame.
-
-Args:
-    frame_start (int): Start frame. Default: 1
-    frame_end (int): End frame. Default: 250
-    frame_current (int|None): Frame to jump to. Default: None (no change)
-    fps (int|None): Frames per second. Default: None (no change)
-
-Result:
-    frame_start (int): Start frame set
-    frame_end (int): End frame set
-    frame_current (int): Current frame after change
-    fps (int): Scene FPS
-"""
-
-import bpy
-
-scene = bpy.context.scene
-scene.frame_start = args.get("frame_start", 1)
-scene.frame_end = args.get("frame_end", 250)
-
-frame_current = args.get("frame_current")
-if frame_current is not None:
-    scene.frame_set(frame_current)
-
-fps = args.get("fps")
-if fps is not None:
-    scene.render.fps = fps
-
-__result__ = {
-    "frame_start": scene.frame_start,
-    "frame_end": scene.frame_end,
-    "frame_current": scene.frame_current,
-    "fps": scene.render.fps,
-}

package/mcps/blender-mcp-server/scripts/library/keyframes.py

@@ -1,59 +0,0 @@
-"""Insert transform keyframes on objects at specified frames.
-
-Args:
-    keyframes (list[dict]): List of keyframe specs. Each dict:
-        - object (str): Object name (required)
-        - frame (int): Frame number (required)
-        - location (list[float]|None): [x, y, z] location to set
-        - rotation (list[float]|None): [rx, ry, rz] Euler rotation in radians
-        - scale (list[float]|None): [sx, sy, sz] scale
-
-Result:
-    inserted (int): Number of keyframes inserted
-    objects (list[str]): Unique object names that received keyframes
-    skipped (list[str]): Objects not found
-"""
-
-import bpy
-
-keyframes = args.get("keyframes", [])
-inserted = 0
-objects_set = set()
-skipped = set()
-
-for kf in keyframes:
-    obj_name = kf.get("object")
-    frame = kf.get("frame")
-    if not obj_name or frame is None:
-        continue
-
-    obj = bpy.data.objects.get(obj_name)
-    if obj is None:
-        skipped.add(obj_name)
-        continue
-
-    loc = kf.get("location")
-    if loc is not None:
-        obj.location = tuple(loc)
-        obj.keyframe_insert(data_path="location", frame=frame)
-        inserted += 1
-
-    rot = kf.get("rotation")
-    if rot is not None:
-        obj.rotation_euler = tuple(rot)
-        obj.keyframe_insert(data_path="rotation_euler", frame=frame)
-        inserted += 1
-
-    scl = kf.get("scale")
-    if scl is not None:
-        obj.scale = tuple(scl)
-        obj.keyframe_insert(data_path="scale", frame=frame)
-        inserted += 1
-
-    objects_set.add(obj_name)
-
-__result__ = {
-    "inserted": inserted,
-    "objects": sorted(objects_set),
-    "skipped": sorted(skipped),
-}

package/mcps/blender-mcp-server/scripts/library/rigid_body.py

@@ -1,52 +0,0 @@
-"""Add rigid body physics to one or more objects.
-
-Args:
-    objects (list[str]): Names of objects to configure.
-    rb_type (str): "ACTIVE" or "PASSIVE". Default: "ACTIVE"
-    mass (float): Mass in kg. Default: 1.0
-    friction (float): Friction coefficient (0-1). Default: 0.5
-    restitution (float): Bounciness (0-1). Default: 0.3
-    collision_shape (str): Shape type. Default: "CONVEX_HULL"
-        Options: "BOX", "SPHERE", "CAPSULE", "CYLINDER", "CONE",
-                 "CONVEX_HULL", "MESH"
-
-Result:
-    configured (list[str]): Objects successfully configured
-    skipped (list[str]): Objects not found
-    rb_type (str): Rigid body type used
-"""
-
-import bpy
-
-obj_names = args.get("objects", [])
-rb_type = args.get("rb_type", "ACTIVE")
-mass = args.get("mass", 1.0)
-friction = args.get("friction", 0.5)
-restitution = args.get("restitution", 0.3)
-collision_shape = args.get("collision_shape", "CONVEX_HULL")
-
-configured = []
-skipped = []
-
-for name in obj_names:
-    obj = bpy.data.objects.get(name)
-    if obj is None:
-        skipped.append(name)
-        continue
-
-    bpy.context.view_layer.objects.active = obj
-    obj.select_set(True)
-    bpy.ops.rigidbody.object_add()
-    obj.rigid_body.type = rb_type
-    obj.rigid_body.mass = mass
-    obj.rigid_body.friction = friction
-    obj.rigid_body.restitution = restitution
-    obj.rigid_body.collision_shape = collision_shape
-    obj.select_set(False)
-    configured.append(name)
-
-__result__ = {
-    "configured": configured,
-    "skipped": skipped,
-    "rb_type": rb_type,
-}

package/mcps/blender-mcp-server/scripts/library/save_blend.py

@@ -1,40 +0,0 @@
-"""Save the current .blend file.
-
-Args:
-    filepath (str|None): Path to save to. Default: None (save in place)
-        If the file has never been saved and no filepath is given, raises an error.
-    compress (bool): Use file compression. Default: True
-    relative_remap (bool): Remap relative paths. Default: True
-
-Result:
-    filepath (str): Absolute path of the saved file
-    compressed (bool): Whether compression was used
-"""
-
-import os
-
-import bpy
-
-filepath = args.get("filepath")
-compress = args.get("compress", True)
-relative_remap = args.get("relative_remap", True)
-
-if filepath:
-    abs_path = os.path.abspath(filepath)
-    if not abs_path.endswith(".blend"):
-        abs_path += ".blend"
-    bpy.ops.wm.save_as_mainfile(
-        filepath=abs_path,
-        compress=compress,
-        relative_remap=relative_remap,
-    )
-else:
-    if not bpy.data.filepath:
-        raise ValueError("File has never been saved. Provide a 'filepath' argument.")
-    bpy.ops.wm.save_mainfile(compress=compress)
-    abs_path = bpy.data.filepath
-
-__result__ = {
-    "filepath": abs_path,
-    "compressed": compress,
-}

package/mcps/blender-mcp-server/scripts/server_start.sh

@@ -1,26 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
-VENV_DIR="${REPO_ROOT}/.venv"
-PYTHON_BIN="${PYTHON_BIN:-python3}"
-INSTALL_TARGET="${INSTALL_TARGET:-${REPO_ROOT}}"
-
-if ! command -v "${PYTHON_BIN}" >/dev/null 2>&1; then
-    echo "error: ${PYTHON_BIN} is not available" >&2
-    exit 1
-fi
-
-if [ ! -d "${VENV_DIR}" ]; then
-    echo "Creating virtual environment at ${VENV_DIR}"
-    "${PYTHON_BIN}" -m venv "${VENV_DIR}"
-fi
-
-echo "Using virtual environment: ${VENV_DIR}"
-"${VENV_DIR}/bin/python" -m pip install --upgrade pip
-"${VENV_DIR}/bin/pip" install -e "${INSTALL_TARGET}"
-
-echo "Starting blender-mcp-server"
-exec "${VENV_DIR}/bin/blender-mcp-server" "$@"

package/mcps/blender-mcp-server/src/blender_mcp_server/__init__.py

@@ -1,3 +0,0 @@
-from blender_mcp_server.server import main
-
-__all__ = ["main"]