test+docs: pytest coverage + CLI usage for component reference wiring

- Add 4 pytest cases (Server/tests/integration/test_manage_components.py)
  covering get_referenceable, set_reference (asset_path + clear), and
  batch_wire. Mocks async_send_command_with_retry; verifies the action
  and parameter shape sent to Unity.
- Document the three new actions in docs/guides/CLI_USAGE.md under
  Component Operations.
- Extend manage_components docstring with examples for the new actions.

Note: Undo and prefab-override correctness require a real Unity Editor
and are not asserted in Python unit tests.

Author: zaferdace

Server/src/services/tools/manage_components.py

@@ -116,6 +116,9 @@ async def manage_components(
     - Remove BoxCollider: action="remove", target=-12345, component_type="BoxCollider"
     - Set single property: action="set_property", target="Enemy", component_type="Rigidbody", property="mass", value=5.0
     - Set multiple properties: action="set_property", target="Enemy", component_type="Rigidbody", properties={"mass": 5.0, "useGravity": false}
+    - List referenceable targets: action="get_referenceable", target="Player", component_type="AudioSource", property="clip"
+    - Set reference (asset): action="set_reference", target="Player", component_type="AudioSource", property="clip", reference_asset_path="Assets/Audio/BGM.mp3"
+    - Wire multiple references: action="batch_wire", target="GameManager", component_type="GameManager", references=[{"property_name": "player", "reference_path": "Player"}]
     """
     unity_instance = await get_unity_instance_from_context(ctx)
 

Server/tests/integration/test_manage_components.py

@@ -1,7 +1,8 @@
 """
 Tests for the manage_components tool.
 
-This tool handles component lifecycle operations (add, remove, set_property).
+This tool handles component lifecycle operations (add, remove, set_property)
+and object reference wiring (get_referenceable, set_reference, batch_wire).
 """
 import pytest
 
@@ -240,3 +241,162 @@ async def fake_send(cmd, params, **kwargs):
     assert captured["params"]["target"] == 12345
     assert captured["params"]["searchMethod"] == "by_id"
 
+
+@pytest.mark.asyncio
+async def test_manage_components_get_referenceable(monkeypatch):
+    """get_referenceable forwards property + discovery flags + limit to Unity."""
+    captured = {}
+
+    async def fake_send(cmd, params, **kwargs):
+        captured["cmd"] = cmd
+        captured["params"] = params
+        return {
+            "success": True,
+            "data": {
+                "scene_objects": [{"name": "Player", "instanceID": 1001}],
+                "assets": [{"name": "BGM", "assetPath": "Assets/Audio/BGM.mp3"}],
+            },
+        }
+
+    monkeypatch.setattr(
+        manage_comp_mod,
+        "async_send_command_with_retry",
+        fake_send,
+    )
+
+    resp = await manage_comp_mod.manage_components(
+        ctx=DummyContext(),
+        action="get_referenceable",
+        target="Player",
+        component_type="AudioSource",
+        property="clip",
+        include_scene=True,
+        include_assets=True,
+        limit=50,
+    )
+
+    assert resp.get("success") is True
+    assert captured["cmd"] == "manage_components"
+    assert captured["params"]["action"] == "get_referenceable"
+    assert captured["params"]["componentType"] == "AudioSource"
+    assert captured["params"]["property"] == "clip"
+    assert captured["params"]["include_scene"] is True
+    assert captured["params"]["include_assets"] is True
+    assert captured["params"]["limit"] == 50
+
+
+@pytest.mark.asyncio
+async def test_manage_components_set_reference_asset_path(monkeypatch):
+    """set_reference forwards reference_asset_path to Unity."""
+    captured = {}
+
+    async def fake_send(cmd, params, **kwargs):
+        captured["params"] = params
+        return {
+            "success": True,
+            "data": {
+                "previous_value": None,
+                "new_value": {"name": "BGM", "assetPath": "Assets/Audio/BGM.mp3"},
+            },
+        }
+
+    monkeypatch.setattr(
+        manage_comp_mod,
+        "async_send_command_with_retry",
+        fake_send,
+    )
+
+    resp = await manage_comp_mod.manage_components(
+        ctx=DummyContext(),
+        action="set_reference",
+        target="Player",
+        component_type="AudioSource",
+        property="clip",
+        reference_asset_path="Assets/Audio/BGM.mp3",
+    )
+
+    assert resp.get("success") is True
+    assert captured["params"]["action"] == "set_reference"
+    assert captured["params"]["property"] == "clip"
+    assert captured["params"]["reference_asset_path"] == "Assets/Audio/BGM.mp3"
+    assert "reference_path" not in captured["params"]
+    assert "reference_instance_id" not in captured["params"]
+
+
+@pytest.mark.asyncio
+async def test_manage_components_set_reference_clear(monkeypatch):
+    """set_reference with clear=True forwards clear flag and omits selectors."""
+    captured = {}
+
+    async def fake_send(cmd, params, **kwargs):
+        captured["params"] = params
+        return {
+            "success": True,
+            "data": {"previous_value": {"name": "BGM"}, "new_value": None},
+        }
+
+    monkeypatch.setattr(
+        manage_comp_mod,
+        "async_send_command_with_retry",
+        fake_send,
+    )
+
+    resp = await manage_comp_mod.manage_components(
+        ctx=DummyContext(),
+        action="set_reference",
+        target="Player",
+        component_type="AudioSource",
+        property="clip",
+        clear=True,
+    )
+
+    assert resp.get("success") is True
+    assert captured["params"]["action"] == "set_reference"
+    assert captured["params"]["clear"] is True
+    assert "reference_path" not in captured["params"]
+    assert "reference_asset_path" not in captured["params"]
+    assert "reference_instance_id" not in captured["params"]
+
+
+@pytest.mark.asyncio
+async def test_manage_components_batch_wire(monkeypatch):
+    """batch_wire forwards references list and atomic flag."""
+    captured = {}
+
+    async def fake_send(cmd, params, **kwargs):
+        captured["params"] = params
+        return {
+            "success": True,
+            "data": {
+                "results": [
+                    {"property": "player", "success": True},
+                    {"property": "bgMusic", "success": True},
+                ]
+            },
+        }
+
+    monkeypatch.setattr(
+        manage_comp_mod,
+        "async_send_command_with_retry",
+        fake_send,
+    )
+
+    references = [
+        {"property_name": "player", "reference_path": "Player"},
+        {"property_name": "bgMusic", "reference_asset_path": "Assets/Audio/BGM.mp3"},
+    ]
+
+    resp = await manage_comp_mod.manage_components(
+        ctx=DummyContext(),
+        action="batch_wire",
+        target="GameManager",
+        component_type="GameManager",
+        references=references,
+        atomic=True,
+    )
+
+    assert resp.get("success") is True
+    assert captured["params"]["action"] == "batch_wire"
+    assert captured["params"]["componentType"] == "GameManager"
+    assert captured["params"]["references"] == references
+    assert captured["params"]["atomic"] is True

docs/guides/CLI_USAGE.md

@@ -108,6 +108,25 @@ unity-mcp component remove "Player" Rigidbody
 
 # Set property
 unity-mcp component set "Player" Rigidbody mass 10
+
+# List valid reference targets for an object reference field
+unity-mcp component get_referenceable "Player" AudioSource clip
+
+# Assign an object reference (project asset by path)
+unity-mcp component set_reference "Player" AudioSource clip \
+  --reference_asset_path "Assets/Audio/BGM.mp3"
+
+# Assign an object reference (scene object by hierarchy path)
+unity-mcp component set_reference "MainCamera" CinemachineCamera Follow \
+  --reference_path "Player"
+
+# Clear an object reference
+unity-mcp component set_reference "Player" AudioSource clip --clear
+
+# Wire multiple references on a component atomically
+unity-mcp component batch_wire "GameManager" GameManager --references \
+  '[{"property_name":"player","reference_path":"Player"},
+    {"property_name":"bgMusic","reference_asset_path":"Assets/Audio/BGM.mp3"}]'
 ```
 
 ### Script Operations