mcpforunityserver 9.0.7__tar.gz → 9.1.0__tar.gz

{mcpforunityserver-9.0.7 → mcpforunityserver-9.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpforunityserver
-Version: 9.0.7
+Version: 9.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
@@ -32,6 +32,7 @@ Requires-Dist: pydantic>=2.12.5
 Requires-Dist: tomli>=2.3.0
 Requires-Dist: fastapi>=0.104.0
 Requires-Dist: uvicorn>=0.35.0
+Requires-Dist: click>=8.1.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
@@ -109,7 +110,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@v9.0.7#subdirectory=Server",
+        "git+https://github.com/CoplayDev/unity-mcp@v9.1.0#subdirectory=Server",
         "mcp-for-unity",
         "--transport",
         "stdio"

{mcpforunityserver-9.0.7 → mcpforunityserver-9.1.0}/README.md

@@ -69,7 +69,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@v9.0.7#subdirectory=Server",
+        "git+https://github.com/CoplayDev/unity-mcp@v9.1.0#subdirectory=Server",
         "mcp-for-unity",
         "--transport",
         "stdio"

{mcpforunityserver-9.0.7 → mcpforunityserver-9.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcpforunityserver"
-version = "9.0.7"
+version = "9.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"
@@ -36,6 +36,7 @@ dependencies = [
  "tomli>=2.3.0",
  "fastapi>=0.104.0",
  "uvicorn>=0.35.0",
+ "click>=8.1.0",
 ]
 
 [project.optional-dependencies]
@@ -51,11 +52,21 @@ Issues = "https://github.com/CoplayDev/unity-mcp/issues"
 
 [project.scripts]
 mcp-for-unity = "main:main"
+unity-mcp = "cli.main:main"
 
 [build-system]
 requires = ["setuptools>=64.0.0", "wheel"]
 build-backend = "setuptools.build_meta"
 
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools]
+py-modules = ["main"]
+
 [tool.coverage.run]
 source = ["src"]
 omit = [

mcpforunityserver-9.1.0/src/cli/__init__.py

@@ -0,0 +1,3 @@
+"""Unity MCP Command Line Interface."""
+
+__version__ = "1.0.0"

mcpforunityserver-9.1.0/src/cli/commands/__init__.py

@@ -0,0 +1,3 @@
+"""CLI command modules."""
+
+# Commands will be registered in main.py

mcpforunityserver-9.1.0/src/cli/commands/animation.py

@@ -0,0 +1,87 @@
+"""Animation CLI commands - placeholder for future implementation."""
+
+import sys
+import click
+from typing import Optional, Any
+
+from cli.utils.config import get_config
+from cli.utils.output import format_output, print_error, print_info
+from cli.utils.connection import run_command, UnityConnectionError
+
+
+@click.group()
+def animation():
+    """Animation operations - control Animator, play animations."""
+    pass
+
+
+@animation.command("play")
+@click.argument("target")
+@click.argument("state_name")
+@click.option(
+    "--layer", "-l",
+    default=0,
+    type=int,
+    help="Animator layer(TODO)."
+)
+@click.option(
+    "--search-method",
+    type=click.Choice(["by_name", "by_path", "by_id"]),
+    default=None,
+    help="How to find the target."
+)
+def play(target: str, state_name: str, layer: int, search_method: Optional[str]):
+    """Play an animation state on a target's Animator.
+
+    \b
+    Examples:
+        unity-mcp animation play "Player" "Walk"
+        unity-mcp animation play "Enemy" "Attack" --layer 1
+    """
+    config = get_config()
+
+    # Set Animator parameter to trigger state
+    params: dict[str, Any] = {
+        "action": "set_property",
+        "target": target,
+        "componentType": "Animator",
+        "property": "Play",
+        "value": state_name,
+        "layer": layer,
+    }
+
+    if search_method:
+        params["searchMethod"] = search_method
+
+    try:
+        result = run_command("manage_components", params, config)
+        click.echo(format_output(result, config.format))
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@animation.command("set-parameter")
+@click.argument("target")
+@click.argument("param_name")
+@click.argument("value")
+@click.option(
+    "--type", "-t",
+    "param_type",
+    type=click.Choice(["float", "int", "bool", "trigger"]),
+    default="float",
+    help="Parameter type."
+)
+def set_parameter(target: str, param_name: str, value: str, param_type: str):
+    """Set an Animator parameter.
+
+    \b
+    Examples:
+        unity-mcp animation set-parameter "Player" "Speed" 5.0
+        unity-mcp animation set-parameter "Player" "IsRunning" true --type bool
+        unity-mcp animation set-parameter "Player" "Jump" "" --type trigger
+    """
+    config = get_config()
+    print_info(
+        "Animation parameter command - requires custom Unity implementation")
+    click.echo(f"Would set {param_name}={value} ({param_type}) on {target}")

mcpforunityserver-9.1.0/src/cli/commands/asset.py

@@ -0,0 +1,310 @@
+"""Asset CLI commands."""
+
+import sys
+import json
+import click
+from typing import Optional, Any
+
+from cli.utils.config import get_config
+from cli.utils.output import format_output, print_error, print_success
+from cli.utils.connection import run_command, UnityConnectionError
+
+
+@click.group()
+def asset():
+    """Asset operations - search, import, create, delete assets."""
+    pass
+
+
+@asset.command("search")
+@click.argument("pattern", default="*")
+@click.option(
+    "--path", "-p",
+    default="Assets",
+    help="Folder path to search in."
+)
+@click.option(
+    "--type", "-t",
+    "filter_type",
+    default=None,
+    help="Filter by asset type (e.g., Material, Prefab, MonoScript)."
+)
+@click.option(
+    "--limit", "-l",
+    default=25,
+    type=int,
+    help="Maximum results per page."
+)
+@click.option(
+    "--page",
+    default=1,
+    type=int,
+    help="Page number (1-based)."
+)
+def search(pattern: str, path: str, filter_type: Optional[str], limit: int, page: int):
+    """Search for assets.
+
+    \b
+    Examples:
+        unity-mcp asset search "*.prefab"
+        unity-mcp asset search "Player*" --path "Assets/Characters"
+        unity-mcp asset search "*" --type Material
+        unity-mcp asset search "t:MonoScript" --path "Assets/Scripts"
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "search",
+        "path": path,
+        "searchPattern": pattern,
+        "pageSize": limit,
+        "pageNumber": page,
+    }
+
+    if filter_type:
+        params["filterType"] = filter_type
+
+    try:
+        result = run_command("manage_asset", params, config)
+        click.echo(format_output(result, config.format))
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("info")
+@click.argument("path")
+@click.option(
+    "--preview",
+    is_flag=True,
+    help="Generate preview thumbnail (may be large)."
+)
+def info(path: str, preview: bool):
+    """Get detailed information about an asset.
+
+    \b
+    Examples:
+        unity-mcp asset info "Assets/Materials/Red.mat"
+        unity-mcp asset info "Assets/Prefabs/Player.prefab" --preview
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "get_info",
+        "path": path,
+        "generatePreview": preview,
+    }
+
+    try:
+        result = run_command("manage_asset", params, config)
+        click.echo(format_output(result, config.format))
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("create")
+@click.argument("path")
+@click.argument("asset_type")
+@click.option(
+    "--properties", "-p",
+    default=None,
+    help='Initial properties as JSON.'
+)
+def create(path: str, asset_type: str, properties: Optional[str]):
+    """Create a new asset.
+
+    \b
+    Examples:
+        unity-mcp asset create "Assets/Materials/Blue.mat" Material
+        unity-mcp asset create "Assets/NewFolder" Folder
+        unity-mcp asset create "Assets/Materials/Custom.mat" Material --properties '{"color": [0,0,1,1]}'
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "create",
+        "path": path,
+        "assetType": asset_type,
+    }
+
+    if properties:
+        try:
+            params["properties"] = json.loads(properties)
+        except json.JSONDecodeError as e:
+            print_error(f"Invalid JSON for properties: {e}")
+            sys.exit(1)
+
+    try:
+        result = run_command("manage_asset", params, config)
+        click.echo(format_output(result, config.format))
+        if result.get("success"):
+            print_success(f"Created {asset_type}: {path}")
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("delete")
+@click.argument("path")
+@click.option(
+    "--force", "-f",
+    is_flag=True,
+    help="Skip confirmation prompt."
+)
+def delete(path: str, force: bool):
+    """Delete an asset.
+
+    \b
+    Examples:
+        unity-mcp asset delete "Assets/OldMaterial.mat"
+        unity-mcp asset delete "Assets/Unused" --force
+    """
+    config = get_config()
+
+    if not force:
+        click.confirm(f"Delete asset '{path}'?", abort=True)
+
+    try:
+        result = run_command(
+            "manage_asset", {"action": "delete", "path": path}, config)
+        click.echo(format_output(result, config.format))
+        if result.get("success"):
+            print_success(f"Deleted: {path}")
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("duplicate")
+@click.argument("source")
+@click.argument("destination")
+def duplicate(source: str, destination: str):
+    """Duplicate an asset.
+
+    \b
+    Examples:
+        unity-mcp asset duplicate "Assets/Materials/Red.mat" "Assets/Materials/RedCopy.mat"
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "duplicate",
+        "path": source,
+        "destination": destination,
+    }
+
+    try:
+        result = run_command("manage_asset", params, config)
+        click.echo(format_output(result, config.format))
+        if result.get("success"):
+            print_success(f"Duplicated to: {destination}")
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("move")
+@click.argument("source")
+@click.argument("destination")
+def move(source: str, destination: str):
+    """Move an asset to a new location.
+
+    \b
+    Examples:
+        unity-mcp asset move "Assets/Old/Material.mat" "Assets/New/Material.mat"
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "move",
+        "path": source,
+        "destination": destination,
+    }
+
+    try:
+        result = run_command("manage_asset", params, config)
+        click.echo(format_output(result, config.format))
+        if result.get("success"):
+            print_success(f"Moved to: {destination}")
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("rename")
+@click.argument("path")
+@click.argument("new_name")
+def rename(path: str, new_name: str):
+    """Rename an asset.
+
+    \b
+    Examples:
+        unity-mcp asset rename "Assets/Materials/Old.mat" "New.mat"
+    """
+    config = get_config()
+
+    # Construct destination path
+    import os
+    dir_path = os.path.dirname(path)
+    destination = os.path.join(dir_path, new_name).replace("\\", "/")
+
+    params: dict[str, Any] = {
+        "action": "rename",
+        "path": path,
+        "destination": destination,
+    }
+
+    try:
+        result = run_command("manage_asset", params, config)
+        click.echo(format_output(result, config.format))
+        if result.get("success"):
+            print_success(f"Renamed to: {new_name}")
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("import")
+@click.argument("path")
+def import_asset(path: str):
+    """Import/reimport an asset.
+
+    \b
+    Examples:
+        unity-mcp asset import "Assets/Textures/NewTexture.png"
+    """
+    config = get_config()
+
+    try:
+        result = run_command(
+            "manage_asset", {"action": "import", "path": path}, config)
+        click.echo(format_output(result, config.format))
+        if result.get("success"):
+            print_success(f"Imported: {path}")
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@asset.command("mkdir")
+@click.argument("path")
+def mkdir(path: str):
+    """Create a folder.
+
+    \b
+    Examples:
+        unity-mcp asset mkdir "Assets/NewFolder"
+        unity-mcp asset mkdir "Assets/Levels/Chapter1"
+    """
+    config = get_config()
+
+    try:
+        result = run_command(
+            "manage_asset", {"action": "create_folder", "path": path}, config)
+        click.echo(format_output(result, config.format))
+        if result.get("success"):
+            print_success(f"Created folder: {path}")
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)

mcpforunityserver-9.1.0/src/cli/commands/audio.py

@@ -0,0 +1,133 @@
+"""Audio CLI commands - placeholder for future implementation."""
+
+import sys
+import click
+from typing import Optional, Any
+
+from cli.utils.config import get_config
+from cli.utils.output import format_output, print_error, print_info
+from cli.utils.connection import run_command, UnityConnectionError
+
+
+@click.group()
+def audio():
+    """Audio operations - AudioSource control, audio settings."""
+    pass
+
+
+@audio.command("play")
+@click.argument("target")
+@click.option(
+    "--clip", "-c",
+    default=None,
+    help="Audio clip path to play."
+)
+@click.option(
+    "--search-method",
+    type=click.Choice(["by_name", "by_path", "by_id"]),
+    default=None,
+    help="How to find the target."
+)
+def play(target: str, clip: Optional[str], search_method: Optional[str]):
+    """Play audio on a target's AudioSource.
+
+    \b
+    Examples:
+        unity-mcp audio play "MusicPlayer"
+        unity-mcp audio play "SFXSource" --clip "Assets/Audio/explosion.wav"
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "set_property",
+        "target": target,
+        "componentType": "AudioSource",
+        "property": "Play",
+        "value": True,
+    }
+
+    if clip:
+        params["clip"] = clip
+
+    if search_method:
+        params["searchMethod"] = search_method
+
+    try:
+        result = run_command("manage_components", params, config)
+        click.echo(format_output(result, config.format))
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@audio.command("stop")
+@click.argument("target")
+@click.option(
+    "--search-method",
+    type=click.Choice(["by_name", "by_path", "by_id"]),
+    default=None,
+    help="How to find the target."
+)
+def stop(target: str, search_method: Optional[str]):
+    """Stop audio on a target's AudioSource.
+
+    \b
+    Examples:
+        unity-mcp audio stop "MusicPlayer"
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "set_property",
+        "target": target,
+        "componentType": "AudioSource",
+        "property": "Stop",
+        "value": True,
+    }
+
+    if search_method:
+        params["searchMethod"] = search_method
+
+    try:
+        result = run_command("manage_components", params, config)
+        click.echo(format_output(result, config.format))
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+@audio.command("volume")
+@click.argument("target")
+@click.argument("level", type=float)
+@click.option(
+    "--search-method",
+    type=click.Choice(["by_name", "by_path", "by_id"]),
+    default=None,
+    help="How to find the target."
+)
+def volume(target: str, level: float, search_method: Optional[str]):
+    """Set audio volume on a target's AudioSource.
+
+    \b
+    Examples:
+        unity-mcp audio volume "MusicPlayer" 0.5
+    """
+    config = get_config()
+
+    params: dict[str, Any] = {
+        "action": "set_property",
+        "target": target,
+        "componentType": "AudioSource",
+        "property": "volume",
+        "value": level,
+    }
+
+    if search_method:
+        params["searchMethod"] = search_method
+
+    try:
+        result = run_command("manage_components", params, config)
+        click.echo(format_output(result, config.format))
+    except UnityConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)