unity-open-mcp 0.1.0

package/dist/unity-install-discovery.d.ts

@@ -0,0 +1,79 @@
+/** A discovered Unity install: the editor executable path + its version folder name. */
+export interface UnityInstall {
+    /** Absolute path to the Unity executable (the thing you spawn). */
+    path: string;
+    /** Version string as named by the install folder (e.g. "6000.4.0f1", "2022.3.62f2"). */
+    version: string;
+}
+export type UnityPathSource = "env" | "discovered";
+export interface ResolvedUnityPath {
+    path: string;
+    version: string;
+    source: UnityPathSource;
+}
+/**
+ * OS-default Unity Hub install roots, matching the Hub's
+ * `get_os_default_hub_paths()`. Each holds version-named subfolders
+ * (`<root>/<version>/Unity.app|Editor/...`).
+ */
+export declare function defaultHubRoots(): string[];
+/**
+ * Roots actually scanned for installs: the OS defaults plus an optional
+ * `UNITY_HUB` env override (the Hub honors the same env var to point at a
+ * non-default install root). Deduped, existing-only.
+ */
+export declare function scannedHubRoots(): string[];
+/**
+ * Resolve the Unity executable path for a version-named install folder,
+ * per-OS. Returns null when the expected binary is absent (folder exists
+ * but is not a valid editor layout). Mirrors the Hub's `is_unity_editor_dir`
+ * + path-to-executable logic.
+ */
+export declare function executableForInstall(installDir: string): string | null;
+/**
+ * Scan the OS-default Hub roots (+ `UNITY_HUB` env override) for version-named
+ * install folders and return the validated executables, sorted newest-first.
+ * Never throws — unreadable/missing dirs are silently skipped (best-effort
+ * discovery). De-duplicates by executable path so an env override pointing at
+ * the same place as an OS default does not double-list.
+ *
+ * `roots` is an optional override (test hook) — when omitted the real
+ * `scannedHubRoots()` is used. Passing an explicit list keeps unit tests
+ * deterministic across machines without monkey-patching env vars.
+ */
+export declare function discoverUnityInstalls(roots?: string[]): UnityInstall[];
+/**
+ * Compare two Unity version strings for sort ordering. Unity versions look
+ * like `YYYY.N.PxX` or `6000.N.PxX` with an optional suffix (`a1`, `b2`,
+ * `f3`, `p4`, `c5`). We split on non-digit runs, compare numeric parts
+ * left-to-right, and fall back to lexicographic for the trailing suffix so
+ * `6000.4.0f1` > `6000.4.0b1` (final > beta, matching the Hub's intent of
+ * surfacing newer/more-stable releases first). Returns >0 / 0 / <0.
+ */
+export declare function compareUnityVersions(a: string, b: string): number;
+/**
+ * True when `candidateVersion` should be preferred for a project whose
+ * running bridge reports `projectVersion`. Matches the full string first,
+ * then the leading dotted prefix (`6000.4` matches `6000.4.0f1`), so a
+ * patch-level difference still pins the right minor line. Null/empty
+ * `projectVersion` matches nothing (caller falls back to newest).
+ */
+export declare function versionMatches(candidateVersion: string, projectVersion?: string | null): boolean;
+/**
+ * Resolve the Unity executable to use for batch operations. Precedence:
+ *   1. `UNITY_PATH` env var — validated to exist; source "env". Not run
+ *      through discovery so an explicit pin always wins even if the path
+ *      points outside the Hub layout.
+ *   2. discovered installs — pick by `preferredVersion` match when given,
+ *      else the newest (first, since discoverUnityInstalls sorts desc).
+ *   3. null — caller surfaces `unity_not_discovered`.
+ *
+ * `preferredVersion` is typically the running bridge's `unityVersion` read
+ * from the instance lock, so on multi-version machines batch picks the same
+ * editor the live project uses.
+ *
+ * `roots` is an optional override (test hook) forwarded to
+ * `discoverUnityInstalls` so tests can point at a temp fixture instead of the
+ * real machine state.
+ */
+export declare function resolveUnityPath(preferredVersion?: string | null, roots?: string[]): ResolvedUnityPath | null;

package/dist/unity-install-discovery.js

@@ -0,0 +1,206 @@
+// Unity-install auto-discovery for the MCP server.
+//
+// Ports the *behavior* of the Hub's Rust discovery
+// (`hub/src-tauri/src/config/discovery.rs::discover_unity_installations`)
+// to TypeScript so `batch-spawn.ts` can find a Unity editor without a hard
+// `UNITY_PATH` env requirement. The two processes do not share code today;
+// this is an independent, TS-idiomatic port kept in sync with the Hub's
+// OS-default paths and `UNITY_HUB` env override.
+//
+// Resolution precedence (see `resolveUnityPath`):
+//   1. `UNITY_PATH` env var (explicit, validated to exist — wins)
+//   2. auto-discovered installs, picking by `preferredVersion` prefix match
+//      against the running bridge's `unityVersion` when available, else newest
+//   3. null (caller surfaces `unity_not_discovered`)
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+/**
+ * OS-default Unity Hub install roots, matching the Hub's
+ * `get_os_default_hub_paths()`. Each holds version-named subfolders
+ * (`<root>/<version>/Unity.app|Editor/...`).
+ */
+export function defaultHubRoots() {
+    if (process.platform === "win32") {
+        return [join("C:", "Program Files", "Unity", "Hub", "Editor")];
+    }
+    if (process.platform === "darwin") {
+        return ["/Applications/Unity/Hub/Editor"];
+    }
+    // Linux + fallback.
+    return [join(homedir(), "Unity", "Hub", "Editor")];
+}
+/**
+ * Roots actually scanned for installs: the OS defaults plus an optional
+ * `UNITY_HUB` env override (the Hub honors the same env var to point at a
+ * non-default install root). Deduped, existing-only.
+ */
+export function scannedHubRoots() {
+    const roots = new Set();
+    for (const r of defaultHubRoots())
+        roots.add(r);
+    const envHub = process.env.UNITY_HUB;
+    if (envHub)
+        roots.add(envHub);
+    const out = [];
+    for (const r of roots) {
+        try {
+            if (existsSync(r) && statSync(r).isDirectory())
+                out.push(r);
+        }
+        catch {
+            // unreadable / missing — skip
+        }
+    }
+    return out;
+}
+/**
+ * Resolve the Unity executable path for a version-named install folder,
+ * per-OS. Returns null when the expected binary is absent (folder exists
+ * but is not a valid editor layout). Mirrors the Hub's `is_unity_editor_dir`
+ * + path-to-executable logic.
+ */
+export function executableForInstall(installDir) {
+    if (process.platform === "darwin") {
+        const exe = join(installDir, "Unity.app", "Contents", "MacOS", "Unity");
+        return existsSync(exe) ? exe : null;
+    }
+    if (process.platform === "win32") {
+        const exe = join(installDir, "Editor", "Unity.exe");
+        return existsSync(exe) ? exe : null;
+    }
+    // Linux.
+    const exe = join(installDir, "Editor", "Unity");
+    return existsSync(exe) ? exe : null;
+}
+/**
+ * Scan the OS-default Hub roots (+ `UNITY_HUB` env override) for version-named
+ * install folders and return the validated executables, sorted newest-first.
+ * Never throws — unreadable/missing dirs are silently skipped (best-effort
+ * discovery). De-duplicates by executable path so an env override pointing at
+ * the same place as an OS default does not double-list.
+ *
+ * `roots` is an optional override (test hook) — when omitted the real
+ * `scannedHubRoots()` is used. Passing an explicit list keeps unit tests
+ * deterministic across machines without monkey-patching env vars.
+ */
+export function discoverUnityInstalls(roots) {
+    const scanRoots = roots ?? scannedHubRoots();
+    const seen = new Map();
+    for (const root of scanRoots) {
+        let entries;
+        try {
+            entries = readdirSync(root);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            const installDir = join(root, name);
+            try {
+                if (!statSync(installDir).isDirectory())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            const exe = executableForInstall(installDir);
+            if (!exe)
+                continue;
+            if (!seen.has(exe)) {
+                seen.set(exe, { path: exe, version: name });
+            }
+        }
+    }
+    const installs = Array.from(seen.values());
+    installs.sort((a, b) => compareUnityVersions(b.version, a.version)); // newest first
+    return installs;
+}
+/**
+ * Compare two Unity version strings for sort ordering. Unity versions look
+ * like `YYYY.N.PxX` or `6000.N.PxX` with an optional suffix (`a1`, `b2`,
+ * `f3`, `p4`, `c5`). We split on non-digit runs, compare numeric parts
+ * left-to-right, and fall back to lexicographic for the trailing suffix so
+ * `6000.4.0f1` > `6000.4.0b1` (final > beta, matching the Hub's intent of
+ * surfacing newer/more-stable releases first). Returns >0 / 0 / <0.
+ */
+export function compareUnityVersions(a, b) {
+    if (a === b)
+        return 0;
+    const partsA = a.split(/[^0-9]+/).filter(Boolean).map((n) => parseInt(n, 10));
+    const partsB = b.split(/[^0-9]+/).filter(Boolean).map((n) => parseInt(n, 10));
+    const len = Math.max(partsA.length, partsB.length);
+    for (let i = 0; i < len; i++) {
+        const av = partsA[i] ?? -1;
+        const bv = partsB[i] ?? -1;
+        if (av !== bv)
+            return av - bv;
+    }
+    // Numeric parts equal — compare the trailing suffix lexically (f > b > a).
+    return a.localeCompare(b);
+}
+/**
+ * True when `candidateVersion` should be preferred for a project whose
+ * running bridge reports `projectVersion`. Matches the full string first,
+ * then the leading dotted prefix (`6000.4` matches `6000.4.0f1`), so a
+ * patch-level difference still pins the right minor line. Null/empty
+ * `projectVersion` matches nothing (caller falls back to newest).
+ */
+export function versionMatches(candidateVersion, projectVersion) {
+    if (!projectVersion)
+        return false;
+    if (candidateVersion === projectVersion)
+        return true;
+    // Strip any trailing patch/suffix from the project version and prefix-match.
+    // "6000.4.0f1" -> prefix "6000.4" (first two numeric groups).
+    const groups = projectVersion.split(/[^0-9]+/).filter(Boolean);
+    if (groups.length >= 2) {
+        const prefix = groups.slice(0, 2).join(".");
+        if (candidateVersion.startsWith(prefix + ".") || candidateVersion.startsWith(prefix)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Resolve the Unity executable to use for batch operations. Precedence:
+ *   1. `UNITY_PATH` env var — validated to exist; source "env". Not run
+ *      through discovery so an explicit pin always wins even if the path
+ *      points outside the Hub layout.
+ *   2. discovered installs — pick by `preferredVersion` match when given,
+ *      else the newest (first, since discoverUnityInstalls sorts desc).
+ *   3. null — caller surfaces `unity_not_discovered`.
+ *
+ * `preferredVersion` is typically the running bridge's `unityVersion` read
+ * from the instance lock, so on multi-version machines batch picks the same
+ * editor the live project uses.
+ *
+ * `roots` is an optional override (test hook) forwarded to
+ * `discoverUnityInstalls` so tests can point at a temp fixture instead of the
+ * real machine state.
+ */
+export function resolveUnityPath(preferredVersion, roots) {
+    const envPath = process.env.UNITY_PATH;
+    if (envPath) {
+        try {
+            if (existsSync(envPath) && statSync(envPath).isFile()) {
+                return { path: envPath, version: "(env override)", source: "env" };
+            }
+        }
+        catch {
+            // fall through to discovery
+        }
+    }
+    const installs = discoverUnityInstalls(roots);
+    if (installs.length === 0)
+        return null;
+    if (preferredVersion) {
+        const match = installs.find((i) => versionMatches(i.version, preferredVersion));
+        if (match)
+            return { path: match.path, version: match.version, source: "discovered" };
+    }
+    // Newest first already.
+    const newest = installs[0];
+    return { path: newest.path, version: newest.version, source: "discovered" };
+}
+//# sourceMappingURL=unity-install-discovery.js.map

package/dist/unity-install-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unity-install-discovery.js","sourceRoot":"","sources":["../src/unity-install-discovery.ts"],"names":[],"mappings":"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"}

package/dist/unity-log.d.ts

@@ -0,0 +1,35 @@
+export type UnityLogPlatform = "win32" | "darwin" | "linux";
+/** Resolve the live Editor.log directory for the current platform. Mirrors
+ *  hub/src-tauri/src/config/logs.rs (editor_logs_dir_*).
+ *  - macOS: ~/Library/Logs/Unity
+ *  - Windows: %LOCALAPPDATA%\Unity\Editor
+ *  - Linux: $XDG_CONFIG_HOME/unity3d or ~/.config/unity3d
+ */
+export declare function editorLogsDir(platform?: UnityLogPlatform): string;
+/** Resolve the live Editor.log file path for the current platform. */
+export declare function editorLogPath(platform?: UnityLogPlatform): string;
+/** Default tail size. Bounded so a multi-MB log can't blow up the tool
+ *  response; 256KB is ample for a compile-error burst (Unity writes the
+ *  diagnostics in a contiguous block near the end of the log). */
+export declare const DEFAULT_LOG_TAIL_BYTES: number;
+export interface ReadLogTailResult {
+    /** Absolute path that was read. */
+    path: string;
+    /** Whether the file existed and was read. */
+    exists: boolean;
+    /** The tail content. Empty when the file is missing or unreadable. */
+    content: string;
+    /** Bytes read (content.length in UTF-8 bytes). 0 when missing. */
+    bytes: number;
+    /** Error message when the file existed but could not be read. */
+    error?: string;
+}
+/**
+ * Read up to `maxBytes` from the END of a file, as a UTF-8 string. Returns
+ * { exists: false } when the file is absent. Never throws — read failures
+ * (permissions, vanished mid-read) surface as { exists, error }.
+ *
+ * The tail is read by seeking to (size - maxBytes) and reading forward, so a
+ * multi-MB log is not loaded in full.
+ */
+export declare function readLogTail(path: string, maxBytes?: number): ReadLogTailResult;

package/dist/unity-log.js

@@ -0,0 +1,110 @@
+// Unity Editor.log path resolution + tail, for the read_compile_errors tool.
+//
+// When the bridge assembly itself fails to compile, every in-bridge channel
+// (read_console, editor_status, an in-bridge CompilationPipeline listener) is
+// dead with it, and batch compile_check can't run either (the batch entry
+// point lives in the same broken assembly, and Unity's per-project lock blocks
+// a second instance). The ONE channel that survives is the live Editor's
+// platform Editor.log — Unity writes CSxxxx diagnostics there regardless of
+// bridge health. This module resolves that path per-OS (porting the logic from
+// hub/src-tauri/src/config/logs.rs) and reads a bounded tail.
+//
+// No runtime deps beyond node built-ins (mcp-server/AGENTS.md).
+import { existsSync, openSync, readSync, fstatSync, closeSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** Resolve the live Editor.log directory for the current platform. Mirrors
+ *  hub/src-tauri/src/config/logs.rs (editor_logs_dir_*).
+ *  - macOS: ~/Library/Logs/Unity
+ *  - Windows: %LOCALAPPDATA%\Unity\Editor
+ *  - Linux: $XDG_CONFIG_HOME/unity3d or ~/.config/unity3d
+ */
+export function editorLogsDir(platform = process.platform) {
+    switch (platform) {
+        case "darwin":
+            return join(homedir(), "Library", "Logs", "Unity");
+        case "win32": {
+            const local = process.env.LOCALAPPDATA;
+            if (local)
+                return join(local, "Unity", "Editor");
+            // LOCALAPPDATA is effectively always set on Windows; fall back to the
+            // Public user profile if it is somehow missing.
+            return join("C:\\Users\\Public\\AppData\\Local", "Unity", "Editor");
+        }
+        case "linux": {
+            const xdg = process.env.XDG_CONFIG_HOME;
+            if (xdg)
+                return join(xdg, "unity3d");
+            return join(homedir(), ".config", "unity3d");
+        }
+        default:
+            return join(homedir(), "Library", "Logs", "Unity");
+    }
+}
+/** Resolve the live Editor.log file path for the current platform. */
+export function editorLogPath(platform = process.platform) {
+    return join(editorLogsDir(platform), "Editor.log");
+}
+/** Default tail size. Bounded so a multi-MB log can't blow up the tool
+ *  response; 256KB is ample for a compile-error burst (Unity writes the
+ *  diagnostics in a contiguous block near the end of the log). */
+export const DEFAULT_LOG_TAIL_BYTES = 256 * 1024;
+/**
+ * Read up to `maxBytes` from the END of a file, as a UTF-8 string. Returns
+ * { exists: false } when the file is absent. Never throws — read failures
+ * (permissions, vanished mid-read) surface as { exists, error }.
+ *
+ * The tail is read by seeking to (size - maxBytes) and reading forward, so a
+ * multi-MB log is not loaded in full.
+ */
+export function readLogTail(path, maxBytes = DEFAULT_LOG_TAIL_BYTES) {
+    if (!existsSync(path)) {
+        return { path, exists: false, content: "", bytes: 0 };
+    }
+    let fd;
+    try {
+        fd = openSync(path, "r");
+        const stat = fstatSync(fd);
+        const size = stat.size;
+        const readLen = Math.min(size, Math.max(0, maxBytes));
+        const start = size - readLen;
+        const buf = Buffer.alloc(readLen);
+        // readSync may return fewer bytes than requested if the file is being
+        // written concurrently; loop until the buffer is filled or we hit EOF.
+        let read = 0;
+        while (read < readLen) {
+            // openSync's positional read overload (offset) is used so we don't rely
+            // on the file pointer's current position.
+            const n = readSync(fd, buf, read, readLen - read, start + read);
+            if (n === 0)
+                break;
+            read += n;
+        }
+        return {
+            path,
+            exists: true,
+            content: buf.subarray(0, read).toString("utf8"),
+            bytes: read,
+        };
+    }
+    catch (err) {
+        return {
+            path,
+            exists: true,
+            content: "",
+            bytes: 0,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+            }
+            catch {
+                // best-effort
+            }
+        }
+    }
+}
+//# sourceMappingURL=unity-log.js.map

package/dist/unity-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unity-log.js","sourceRoot":"","sources":["../src/unity-log.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "unity-open-mcp",
+  "version": "0.1.0",
+  "description": "MCP server (stdio) routing tool calls to the live Unity Open MCP Bridge or batch Unity processes.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "unity-open-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:test": "tsc -p tsconfig.test.json",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build:test && node --test 'dist-test/**/*.test.js'",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "unity",
+    "unity3d",
+    "ai",
+    "agent",
+    "claude",
+    "cursor",
+    "opencode",
+    "stdio"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "~5.6.2"
+  },
+  "license": "MIT",
+  "author": "Alexey Perov",
+  "homepage": "https://github.com/AlexeyPerov/Unity-Open-MCP",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AlexeyPerov/Unity-Open-MCP.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AlexeyPerov/Unity-Open-MCP/issues"
+  }
+}