Restore Python 3.10 lockfiles and package list_unity_instances tool

Author: dsarno

MCPForUnity/UnityMcpServer~/src/pyproject.toml

@@ -3,7 +3,7 @@ name = "MCPForUnityServer"
 version = "6.3.0"
 description = "MCP for Unity Server: A Unity package for Unity Editor integration via the Model Context Protocol (MCP)."
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.10"
 dependencies = [
  "httpx>=0.27.2",
  "fastmcp>=2.13.0",

MCPForUnity/UnityMcpServer~/src/tools/list_unity_instances.py

@@ -0,0 +1,70 @@
+"""
+Tool to list all available Unity Editor instances.
+"""
+from typing import Annotated, Any
+
+from fastmcp import Context
+from registry import mcp_for_unity_tool
+from unity_connection import get_unity_connection_pool
+
+
+@mcp_for_unity_tool(description="List all running Unity Editor instances with their details.")
+def list_unity_instances(
+    ctx: Context,
+    force_refresh: Annotated[bool, "Force refresh the instance list, bypassing cache"] = False
+) -> dict[str, Any]:
+    """
+    List all available Unity Editor instances.
+
+    Returns information about each instance including:
+    - id: Unique identifier (ProjectName@hash)
+    - name: Project name
+    - path: Full project path
+    - hash: 8-character hash of project path
+    - port: TCP port number
+    - status: Current status (running, reloading, etc.)
+    - last_heartbeat: Last heartbeat timestamp
+    - unity_version: Unity version (if available)
+
+    Args:
+        force_refresh: If True, bypass cache and scan immediately
+
+    Returns:
+        Dictionary containing list of instances and metadata
+    """
+    ctx.info(f"Listing Unity instances (force_refresh={force_refresh})")
+
+    try:
+        pool = get_unity_connection_pool()
+        instances = pool.discover_all_instances(force_refresh=force_refresh)
+
+        # Check for duplicate project names
+        name_counts = {}
+        for inst in instances:
+            name_counts[inst.name] = name_counts.get(inst.name, 0) + 1
+
+        duplicates = [name for name, count in name_counts.items() if count > 1]
+
+        result = {
+            "success": True,
+            "instance_count": len(instances),
+            "instances": [inst.to_dict() for inst in instances],
+        }
+
+        if duplicates:
+            result["warning"] = (
+                f"Multiple instances found with duplicate project names: {duplicates}. "
+                f"Use full format (e.g., 'ProjectName@hash') to specify which instance."
+            )
+
+        return result
+
+    except Exception as e:
+        ctx.error(f"Error listing Unity instances: {e}")
+        return {
+            "success": False,
+            "error": f"Failed to list Unity instances: {str(e)}",
+            "instance_count": 0,
+            "instances": []
+        }
+