chuk-mcp-stage

Links a visual object to a physics simulation body so that
the physics simulation drives the object's animation.

Args:
    scene_id: Scene identifier
    object_id: Scene object ID
    physics_body_id: Physics body ID from chuk-mcp-physics
        Format: "rapier://sim-{sim_id}/body-{body_id}"
        Example: "rapier://sim-abc123/body-ball"

Returns:
    BindPhysicsResponse confirmation

Tips for LLMs:
    - Create physics body first using chuk-mcp-physics
    - Then create matching scene object with same shape/size
    - Bind them together so physics drives visuals
    - Use stage_bake_simulation to convert physics → keyframes

Example:
    # 1. Create physics simulation (chuk-mcp-physics)
    sim = await create_simulation(gravity_y=-9.81)

    # 2. Add physics body
    await add_rigid_body(
        sim_id=sim.sim_id,
        body_id="ball",
        body_type="dynamic",
        shape="sphere",
        radius=1.0,
        position=[0, 5, 0]
    )

    # 3. Create scene object
    await stage_add_object(
        scene_id=scene_id,
        object_id="ball",
        object_type="sphere",
        radius=1.0,
        position_y=5.0
    )

    # 4. Bind them
    await stage_bind_physics(
        scene_id=scene_id,
        object_id="ball",
        physics_body_id=f"rapier://{sim.sim_id}/body-ball"
    )