mcpforunityserver 10.0.2__tar.gz → 10.1.0__tar.gz

{mcpforunityserver-10.0.2/src/mcpforunityserver.egg-info → mcpforunityserver-10.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpforunityserver
-Version: 10.0.2
+Version: 10.1.0
 Summary: MCP for Unity Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP).
 Author-email: Marcus Sanatan <msanatan@gmail.com>, David Sarno <david.sarno@gmail.com>, Wu Shutong <martinwfire@gmail.com>
 License-Expression: MIT
@@ -115,7 +115,7 @@ Use this to run the latest released version from the repository. Change the vers
       "command": "uvx",
       "args": [
         "--from",
-        "git+https://github.com/CoplayDev/unity-mcp@v10.0.2#subdirectory=Server",
+        "git+https://github.com/CoplayDev/unity-mcp@v10.1.0#subdirectory=Server",
         "mcp-for-unity",
         "--transport",
         "stdio"

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0}/README.md

@@ -71,7 +71,7 @@ Use this to run the latest released version from the repository. Change the vers
       "command": "uvx",
       "args": [
         "--from",
-        "git+https://github.com/CoplayDev/unity-mcp@v10.0.2#subdirectory=Server",
+        "git+https://github.com/CoplayDev/unity-mcp@v10.1.0#subdirectory=Server",
         "mcp-for-unity",
         "--transport",
         "stdio"

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcpforunityserver"
-version = "10.0.2"
+version = "10.1.0"
 description = "MCP for Unity Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP)."
 readme = "README.md"
 license = "MIT"

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0}/src/cli/commands/asset_gen.py

@@ -1,4 +1,4 @@
-"""AI asset generation CLI commands (3D model gen/import, 2D image gen).
+"""AI asset generation CLI commands (3D model gen/import, 2D image gen, audio gen).
 
 Thin pass-through to Unity over HTTP: these commands carry NO API keys and NO
 file bytes. The C# side reads provider keys from the OS secure store, performs
@@ -38,6 +38,7 @@ def _emit(result, config, verb):
 @click.option("--target-size", default=None, type=float, help="Normalize largest dimension (meters).")
 @click.option("--texture/--no-texture", "texture", default=None, help="Generate textures.")
 @click.option("--tier", default=None, help="Provider quality/cost tier.")
+@click.option("--model", default=None, help="Provider model id/version (omit for the GUI-selected default).")
 @click.option("--name", default=None, help="Base name for the imported asset.")
 @click.option("--output-folder", default=None, help="Destination folder under Assets/.")
 @handle_unity_errors
@@ -51,6 +52,7 @@ def generate_model(
     target_size: Optional[float],
     texture: Optional[bool],
     tier: Optional[str],
+    model: Optional[str],
     name: Optional[str],
     output_folder: Optional[str],
 ):
@@ -74,6 +76,7 @@ def generate_model(
         "targetSize": target_size,
         "texture": texture,
         "tier": tier,
+        "model": model,
         "name": name,
         "outputFolder": output_folder,
     }
@@ -197,6 +200,46 @@ def generate_image(
     _emit(result, config, "Generation")
 
 
+@asset_gen.command("generate-audio")
+@click.option("--provider", default=None, help="Provider id (fal).")
+@click.option("--prompt", default=None, help="Text prompt describing the sound or music.")
+@click.option("--model", default=None, help="fal model id (omit for the GUI-selected default).")
+@click.option("--duration", default=None, type=float, help="Requested length in seconds (soft-clamped per model).")
+@click.option("--name", default=None, help="Base name for the imported asset.")
+@click.option("--output-folder", default=None, help="Destination folder under Assets/.")
+@handle_unity_errors
+def generate_audio(
+    provider: Optional[str],
+    prompt: Optional[str],
+    model: Optional[str],
+    duration: Optional[float],
+    name: Optional[str],
+    output_folder: Optional[str],
+):
+    """Generate audio (SFX / music) with a fal.ai model.
+
+    \b
+    Examples:
+        unity-mcp asset-gen generate-audio --provider fal --prompt "8-bit coin pickup"
+        unity-mcp asset-gen generate-audio --prompt "calm ambient loop" --duration 30
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {"action": "generate"}
+    optional = {
+        "provider": provider,
+        "prompt": prompt,
+        "model": model,
+        "duration": duration,
+        "name": name,
+        "outputFolder": output_folder,
+    }
+    params.update({k: v for k, v in optional.items() if v is not None})
+
+    result = run_command("generate_audio", params, config)
+    _emit(result, config, "Generation")
+
+
 @asset_gen.command("status")
 @click.option("--job-id", "job_id", required=True, help="Job id returned by a generate/import command.")
 @handle_unity_errors

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0/src/mcpforunityserver.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpforunityserver
-Version: 10.0.2
+Version: 10.1.0
 Summary: MCP for Unity Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP).
 Author-email: Marcus Sanatan <msanatan@gmail.com>, David Sarno <david.sarno@gmail.com>, Wu Shutong <martinwfire@gmail.com>
 License-Expression: MIT
@@ -115,7 +115,7 @@ Use this to run the latest released version from the repository. Change the vers
       "command": "uvx",
       "args": [
         "--from",
-        "git+https://github.com/CoplayDev/unity-mcp@v10.0.2#subdirectory=Server",
+        "git+https://github.com/CoplayDev/unity-mcp@v10.1.0#subdirectory=Server",
         "mcp-for-unity",
         "--transport",
         "stdio"

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0}/src/mcpforunityserver.egg-info/SOURCES.txt

@@ -92,6 +92,7 @@ src/services/tools/execute_custom_tool.py
 src/services/tools/execute_menu_item.py
 src/services/tools/find_gameobjects.py
 src/services/tools/find_in_file.py
+src/services/tools/generate_audio.py
 src/services/tools/generate_image.py
 src/services/tools/generate_model.py
 src/services/tools/import_model.py
@@ -139,6 +140,7 @@ src/transport/legacy/unity_connection.py
 src/utils/focus_nudge.py
 src/utils/log_paths.py
 src/utils/module_discovery.py
+tests/test_asset_gen_audio.py
 tests/test_asset_gen_image.py
 tests/test_asset_gen_import.py
 tests/test_asset_gen_import_file.py

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0}/src/services/registry/tool_registry.py

@@ -25,7 +25,7 @@ TOOL_GROUPS: dict[str, str] = {
     "testing": "Test runner & async test jobs",
     "probuilder": "ProBuilder 3D modeling – requires com.unity.probuilder package",
     "profiling": "Unity Profiler session control, counters, memory snapshots & Frame Debugger",
-    "asset_gen": "AI asset generation – 3D model gen/import & 2D image gen (bring-your-own-key)",
+    "asset_gen": "AI asset generation – 3D model gen/import, 2D image gen & audio gen (bring-your-own-key)",
 }
 
 DEFAULT_ENABLED_GROUPS: set[str] = {"core"}

mcpforunityserver-10.1.0/src/services/tools/generate_audio.py

@@ -0,0 +1,79 @@
+"""
+Defines the generate_audio tool for AI audio (SFX / music) generation in Unity.
+
+Thin pass-through: this tool carries NO API keys and NO file bytes. The C# side
+reads the user's fal.ai key from the OS secure store, performs the provider
+HTTPS call, downloads the result, and imports it as an AudioClip.
+"""
+from typing import Annotated, Any, Literal
+
+from fastmcp import Context
+from mcp.types import ToolAnnotations
+
+from services.registry import mcp_for_unity_tool
+from services.tools import get_unity_instance_from_context
+from transport.unity_transport import send_with_unity_instance
+from transport.legacy.unity_connection import async_send_command_with_retry
+
+
+@mcp_for_unity_tool(
+    group="asset_gen",
+    description=(
+        "Generate audio (sound effects and background music) with fal.ai models and import "
+        "them as AudioClips into the Unity project. Bring-your-own-key: the fal key lives in "
+        "the editor's secure store (shared with image generation) and never crosses the bridge.\n\n"
+        "MODELS (all via fal.ai): fal-ai/stable-audio-25/text-to-audio (music + SFX, <=190s), "
+        "cassetteai/sound-effects-generator (SFX, <=30s), cassetteai/music-generator (music), "
+        "fal-ai/lyria2 (music). Omit model to use the model selected in the "
+        "MCP for Unity -> Asset Generation tab.\n\n"
+        "ACTIONS:\n"
+        "- generate: Submit an audio job from a text prompt. Returns { job_id }; poll with the "
+        "status action. Params: provider (fal), prompt, model, duration (seconds), name, "
+        "output_folder.\n"
+        "- status: Poll an async job by job_id -> { state, progress, assetPath?, error? }.\n"
+        "- cancel: Cancel an in-flight job by job_id.\n"
+        "- list_providers: List configured audio providers and capabilities (no key values)."
+    ),
+    annotations=ToolAnnotations(
+        title="Generate Audio",
+        destructiveHint=False,
+    ),
+)
+async def generate_audio(
+    ctx: Context,
+    action: Annotated[Literal["generate", "status", "cancel", "list_providers"],
+                      "Action to perform."],
+
+    provider: Annotated[str, "Provider id (fal)."] | None = None,
+    prompt: Annotated[str, "Text prompt describing the sound or music."] | None = None,
+    model: Annotated[str, "fal model id (e.g. fal-ai/stable-audio-25/text-to-audio). "
+                     "Omit to use the GUI-selected default."] | None = None,
+    duration: Annotated[float, "Requested length in seconds (soft-clamped per model)."] | None = None,
+    name: Annotated[str, "Base name for the imported asset."] | None = None,
+    output_folder: Annotated[str, "Destination folder under Assets/ for the import."] | None = None,
+    job_id: Annotated[str, "Job id for status/cancel."] | None = None,
+) -> dict[str, Any]:
+    unity_instance = await get_unity_instance_from_context(ctx)
+
+    params_dict = {
+        "action": action.lower(),
+        "provider": provider,
+        "prompt": prompt,
+        "model": model,
+        "duration": duration,
+        "name": name,
+        "outputFolder": output_folder,
+        "jobId": job_id,
+    }
+
+    # Remove None values
+    params_dict = {k: v for k, v in params_dict.items() if v is not None}
+
+    result = await send_with_unity_instance(
+        async_send_command_with_retry,
+        unity_instance,
+        "generate_audio",
+        params_dict,
+    )
+
+    return result if isinstance(result, dict) else {"success": False, "message": str(result)}

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0}/src/services/tools/generate_model.py

@@ -26,7 +26,7 @@ from transport.legacy.unity_connection import async_send_command_with_retry
         "- generate: Submit a generation job (text->3D or image->3D). Returns { job_id } "
         "immediately; poll with the status action. Params: provider, mode (text|image), "
         "prompt, image_path|image_url, format (glb|fbx|obj|usdz), target_size, texture, "
-        "tier, name, output_folder.\n"
+        "tier, model, name, output_folder.\n"
         "- status: Poll an async job by job_id -> { state, progress, assetPath?, error? }.\n"
         "- cancel: Cancel an in-flight job by job_id.\n"
         "- list_providers: List configured 3D providers and capabilities (no key values)."
@@ -50,6 +50,8 @@ async def generate_model(
     target_size: Annotated[float, "Normalize the largest dimension to this size (meters)."] | None = None,
     texture: Annotated[bool, "Whether to generate textures for the model."] | None = None,
     tier: Annotated[str, "Provider quality/cost tier."] | None = None,
+    model: Annotated[str, "Provider model id/version (e.g. Tripo v3.1, Meshy meshy-6). "
+                     "Omit for the GUI-selected default."] | None = None,
     name: Annotated[str, "Base name for the imported asset."] | None = None,
     output_folder: Annotated[str, "Destination folder under Assets/ for the import."] | None = None,
     job_id: Annotated[str, "Job id for status/cancel."] | None = None,
@@ -67,6 +69,7 @@ async def generate_model(
         "targetSize": target_size,
         "texture": texture,
         "tier": tier,
+        "model": model,
         "name": name,
         "outputFolder": output_folder,
         "jobId": job_id,

mcpforunityserver-10.1.0/tests/test_asset_gen_audio.py

@@ -0,0 +1,145 @@
+"""Tests for the generate_audio asset-gen tool and CLI command (fal.ai).
+
+Pass-through tool: NO API keys, NO file bytes. Unity transport fully mocked.
+"""
+
+import asyncio
+import pytest
+from unittest.mock import patch, MagicMock, AsyncMock
+from click.testing import CliRunner
+
+from cli.commands.asset_gen import asset_gen
+from cli.utils.config import CLIConfig
+from services.registry import get_registered_tools
+
+from services.tools import generate_audio as generate_audio_module
+from services.tools.generate_audio import generate_audio
+
+
+COMMAND = "generate_audio"
+ALLOWED_KEYS = {
+    "action", "provider", "prompt", "model", "duration", "name", "outputFolder", "jobId",
+}
+
+
+def _call_tool(**kwargs):
+    ctx = MagicMock()
+    with patch.object(generate_audio_module, "get_unity_instance_from_context",
+                      new=AsyncMock(return_value="unity-1")):
+        with patch.object(generate_audio_module, "send_with_unity_instance",
+                          new=AsyncMock(return_value={"success": True, "data": {}})) as mock_send:
+            result = asyncio.run(generate_audio(ctx, **kwargs))
+    return result, mock_send.call_args.args
+
+
+def _sent_command(sent_args):
+    return sent_args[2]
+
+
+def _sent_params(sent_args):
+    return sent_args[3]
+
+
+@pytest.fixture
+def runner():
+    return CliRunner()
+
+
+@pytest.fixture
+def mock_config():
+    return CLIConfig(host="127.0.0.1", port=8080, timeout=30, format="text", unity_instance=None)
+
+
+@pytest.fixture
+def cli_runner(runner, mock_config):
+    def _invoke(args):
+        with patch("cli.commands.asset_gen.get_config", return_value=mock_config):
+            with patch("cli.commands.asset_gen.run_command",
+                       return_value={"success": True, "message": "OK", "data": {}}) as mock_run:
+                result = runner.invoke(asset_gen, args)
+                return result, mock_run
+    return _invoke
+
+
+class TestGenerateAudioRegistration:
+    def test_tool_registered_under_asset_gen_group(self):
+        tools = get_registered_tools()
+        tool = next((t for t in tools if t["name"] == "generate_audio"), None)
+        assert tool is not None
+        assert tool["group"] == "asset_gen"
+
+
+class TestGenerateAudioRouting:
+    def test_generate_routes_to_command(self):
+        _, sent = _call_tool(action="generate", provider="fal", prompt="8-bit coin pickup")
+        assert _sent_command(sent) == COMMAND
+        assert _sent_params(sent)["action"] == "generate"
+
+    def test_status_and_job_id_mapping(self):
+        _, sent = _call_tool(action="status", job_id="j5")
+        assert _sent_params(sent) == {"action": "status", "jobId": "j5"}
+
+    def test_param_camelcase_mapping(self):
+        _, sent = _call_tool(
+            action="generate", provider="fal", prompt="rain", duration=30.0,
+            output_folder="Assets/Generated/Audio",
+        )
+        params = _sent_params(sent)
+        assert params["outputFolder"] == "Assets/Generated/Audio"
+        assert params["duration"] == 30.0
+        for snake in ("output_folder", "job_id"):
+            assert snake not in params
+
+    def test_action_is_lowercased(self):
+        _, sent = _call_tool(action="GENERATE", prompt="p")
+        assert _sent_params(sent)["action"] == "generate"
+
+    def test_omitting_model_drops_it(self):
+        # Load-bearing precondition for the GUI-selected default: an omitted model must NOT be
+        # sent, so the C# side falls back to the panel selection / catalog default.
+        _, sent = _call_tool(action="generate", provider="fal", prompt="p")
+        params = _sent_params(sent)
+        assert "model" not in params
+        assert params == {"action": "generate", "provider": "fal", "prompt": "p"}
+
+    def test_explicit_model_passes_through(self):
+        _, sent = _call_tool(action="generate", provider="fal", prompt="p",
+                             model="cassetteai/sound-effects-generator")
+        assert _sent_params(sent)["model"] == "cassetteai/sound-effects-generator"
+
+    def test_no_secret_keys_in_payload(self):
+        _, sent = _call_tool(
+            action="generate", provider="fal", prompt="p",
+            model="fal-ai/stable-audio-25/text-to-audio", duration=12.5, name="Sfx",
+            output_folder="Assets/Generated/Audio", job_id="j",
+        )
+        params = _sent_params(sent)
+        assert set(params.keys()).issubset(ALLOWED_KEYS)
+        joined = " ".join(params.keys()).lower()
+        for forbidden in ("key", "secret", "token", "apikey", "password"):
+            assert forbidden not in joined
+
+    def test_non_dict_response_guarded(self):
+        ctx = MagicMock()
+        with patch.object(generate_audio_module, "get_unity_instance_from_context",
+                          new=AsyncMock(return_value="u")):
+            with patch.object(generate_audio_module, "send_with_unity_instance",
+                              new=AsyncMock(return_value=42)):
+                result = asyncio.run(generate_audio(ctx, action="status", job_id="j"))
+        assert result["success"] is False
+        assert "42" in result["message"]
+
+
+class TestGenerateAudioCLI:
+    def test_generate_audio_cli(self, cli_runner):
+        result, mock_run = cli_runner([
+            "generate-audio", "--provider", "fal", "--prompt", "ambient", "--duration", "30",
+        ])
+        assert result.exit_code == 0
+        command = mock_run.call_args.args[0]
+        params = mock_run.call_args.args[1]
+        assert command == COMMAND
+        assert params["action"] == "generate"
+        assert params["provider"] == "fal"
+        assert params["duration"] == 30.0
+        assert set(params.keys()).issubset(ALLOWED_KEYS)

{mcpforunityserver-10.0.2 → mcpforunityserver-10.1.0}/tests/test_asset_gen_model.py

@@ -22,7 +22,7 @@ COMMAND = "generate_model"
 # Every camelCase key the tool is allowed to send. Crucially, no key/secret param.
 ALLOWED_KEYS = {
     "action", "provider", "mode", "prompt", "imagePath", "imageUrl",
-    "format", "targetSize", "texture", "tier", "name", "outputFolder", "jobId",
+    "format", "targetSize", "texture", "tier", "model", "name", "outputFolder", "jobId",
 }
 
 
@@ -130,6 +130,15 @@ class TestGenerateModelRouting:
         for snake in ("image_path", "image_url", "target_size", "output_folder", "job_id"):
             assert snake not in params
 
+    def test_model_param_passthrough(self):
+        _, sent = _call_tool(action="generate", provider="tripo", prompt="x", model="v3.1-20260211")
+        params = _sent_params(sent)
+        assert params["model"] == "v3.1-20260211"
+
+    def test_model_omitted_is_dropped(self):
+        _, sent = _call_tool(action="generate", provider="tripo", prompt="x")
+        assert "model" not in _sent_params(sent)
+
     def test_none_values_stripped(self):
         _, sent = _call_tool(action="generate", provider="tripo", prompt="x")
         params = _sent_params(sent)