chore: import upstream snapshot with attribution

2026-07-13 12:49:17 +08:00
commit 7243d5823b
2201 changed files with 257291 additions and 0 deletions
@@ -0,0 +1,132 @@
+import os
+import sys
+import types
+from pathlib import Path
+
+SERVER_ROOT = Path(__file__).resolve().parents[2]
+if str(SERVER_ROOT) not in sys.path:
+    sys.path.insert(0, str(SERVER_ROOT))
+SERVER_SRC = SERVER_ROOT / "src"
+if str(SERVER_SRC) not in sys.path:
+    sys.path.insert(0, str(SERVER_SRC))
+
+# Ensure telemetry is disabled during test collection and execution to avoid
+# any background network or thread startup that could slow or block pytest.
+os.environ.setdefault("DISABLE_TELEMETRY", "true")
+os.environ.setdefault("UNITY_MCP_DISABLE_TELEMETRY", "true")
+os.environ.setdefault("MCP_DISABLE_TELEMETRY", "true")
+
+# NOTE: These tests are integration tests for the MCP server Python code.
+# They test tools, resources, and utilities without requiring Unity to be running.
+# Tests can now import directly from the parent package since they're inside src/
+# To run: cd Server && uv run pytest tests/integration/ -v
+
+# Stub telemetry modules to avoid file I/O during import of tools package
+telemetry = types.ModuleType("telemetry")
+
+
+def _noop(*args, **kwargs):
+    pass
+
+
+class MilestoneType:
+    pass
+
+
+telemetry.record_resource_usage = _noop
+telemetry.record_tool_usage = _noop
+telemetry.record_milestone = _noop
+telemetry.MilestoneType = MilestoneType
+telemetry.get_package_version = lambda: "0.0.0"
+sys.modules.setdefault("telemetry", telemetry)
+
+telemetry_decorator = types.ModuleType("telemetry_decorator")
+
+
+def _noop_decorator(*_dargs, **_dkwargs):
+    def _wrap(fn):
+        return fn
+
+    return _wrap
+
+
+telemetry_decorator.telemetry_tool = _noop_decorator
+telemetry_decorator.telemetry_resource = _noop_decorator
+sys.modules.setdefault("telemetry_decorator", telemetry_decorator)
+
+# Stub fastmcp module (not mcp.server.fastmcp)
+fastmcp = types.ModuleType("fastmcp")
+
+
+class _DummyFastMCP:
+    pass
+
+
+class _DummyContext:
+    pass
+
+
+class _DummyMiddleware:
+    """Base middleware class stub."""
+    pass
+
+
+class _DummyMiddlewareContext:
+    """Middleware context stub."""
+    pass
+
+
+class _DummyToolResult:
+    """Stub for fastmcp.server.server.ToolResult"""
+    def __init__(self, content=None, is_error=False):
+        self.content = content or []
+        self.is_error = is_error
+
+
+fastmcp.FastMCP = _DummyFastMCP
+fastmcp.Context = _DummyContext
+sys.modules.setdefault("fastmcp", fastmcp)
+
+# Stub fastmcp.server, fastmcp.server.middleware, fastmcp.server.server submodules
+fastmcp_server = types.ModuleType("fastmcp.server")
+fastmcp_server_middleware = types.ModuleType("fastmcp.server.middleware")
+fastmcp_server_middleware.Middleware = _DummyMiddleware
+fastmcp_server_middleware.MiddlewareContext = _DummyMiddlewareContext
+fastmcp_server_server = types.ModuleType("fastmcp.server.server")
+fastmcp_server_server.ToolResult = _DummyToolResult
+fastmcp.server = fastmcp_server
+fastmcp_server.middleware = fastmcp_server_middleware
+fastmcp_server.server = fastmcp_server_server
+sys.modules.setdefault("fastmcp.server", fastmcp_server)
+sys.modules.setdefault("fastmcp.server.middleware", fastmcp_server_middleware)
+sys.modules.setdefault("fastmcp.server.server", fastmcp_server_server)
+
+# Stub mcp.types for TextContent, ImageContent, ToolAnnotations
+_mcp_types = sys.modules.get("mcp.types")
+if _mcp_types is None:
+    _mcp_mod = sys.modules.setdefault("mcp", types.ModuleType("mcp"))
+    _mcp_types = types.ModuleType("mcp.types")
+
+    class _TextContent:
+        def __init__(self, **kwargs):
+            for k, v in kwargs.items():
+                setattr(self, k, v)
+
+    class _ImageContent:
+        def __init__(self, **kwargs):
+            for k, v in kwargs.items():
+                setattr(self, k, v)
+
+    class _ToolAnnotations:
+        def __init__(self, **kwargs):
+            for k, v in kwargs.items():
+                setattr(self, k, v)
+
+    _mcp_types.TextContent = _TextContent
+    _mcp_types.ImageContent = _ImageContent
+    _mcp_types.ToolAnnotations = _ToolAnnotations
+    _mcp_mod.types = _mcp_types
+    sys.modules["mcp.types"] = _mcp_types
+
+# Note: starlette is now a proper dependency (via mcp package), so we don't stub it anymore.
+# The real starlette package will be imported when needed.