unity-mcp-cli 0.51.6

package/bin/unity-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/commands/configure.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const configureCommand: Command;

package/dist/commands/configure.js

@@ -0,0 +1,83 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import { getOrCreateConfig, writeConfig, updateFeatures } from '../utils/config.js';
+function parseCommaSeparated(value) {
+    return value.split(',').map((s) => s.trim()).filter(Boolean);
+}
+export const configureCommand = new Command('configure')
+    .description('Configure MCP tools, prompts, and resources in AI-Game-Developer-Config.json')
+    .requiredOption('--project-path <path>', 'Path to the Unity project')
+    .option('--enable-tools <names>', 'Enable specific tools (comma-separated)', parseCommaSeparated)
+    .option('--disable-tools <names>', 'Disable specific tools (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-tools', 'Enable all tools')
+    .option('--disable-all-tools', 'Disable all tools')
+    .option('--enable-prompts <names>', 'Enable specific prompts (comma-separated)', parseCommaSeparated)
+    .option('--disable-prompts <names>', 'Disable specific prompts (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-prompts', 'Enable all prompts')
+    .option('--disable-all-prompts', 'Disable all prompts')
+    .option('--enable-resources <names>', 'Enable specific resources (comma-separated)', parseCommaSeparated)
+    .option('--disable-resources <names>', 'Disable specific resources (comma-separated)', parseCommaSeparated)
+    .option('--enable-all-resources', 'Enable all resources')
+    .option('--disable-all-resources', 'Disable all resources')
+    .option('--list', 'List current configuration')
+    .action(async (options) => {
+    const projectPath = path.resolve(options.projectPath);
+    if (!fs.existsSync(projectPath)) {
+        console.error(`Error: Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    const config = getOrCreateConfig(projectPath);
+    if (options.list) {
+        console.log('\nCurrent configuration:');
+        console.log(`  Host: ${config.host ?? 'not set'}`);
+        console.log(`  Keep Connected: ${config.keepConnected ?? false}`);
+        console.log(`  Transport: ${config.transportMethod ?? 'streamableHttp'}`);
+        console.log(`  Auth: ${config.authOption ?? 'none'}`);
+        const printFeatures = (label, features) => {
+            if (!features || features.length === 0) {
+                console.log(`\n  ${label}: (none configured - all enabled by default)`);
+                return;
+            }
+            console.log(`\n  ${label}:`);
+            for (const f of features) {
+                const status = f.enabled ? '[enabled]' : '[disabled]';
+                console.log(`    ${status} ${f.name}`);
+            }
+        };
+        printFeatures('Tools', config.tools);
+        printFeatures('Prompts', config.prompts);
+        printFeatures('Resources', config.resources);
+        return;
+    }
+    // Apply tool changes
+    if (options.enableTools || options.disableTools || options.enableAllTools || options.disableAllTools) {
+        updateFeatures(config, 'tools', {
+            enableNames: options.enableTools,
+            disableNames: options.disableTools,
+            enableAll: options.enableAllTools,
+            disableAll: options.disableAllTools,
+        });
+    }
+    // Apply prompt changes
+    if (options.enablePrompts || options.disablePrompts || options.enableAllPrompts || options.disableAllPrompts) {
+        updateFeatures(config, 'prompts', {
+            enableNames: options.enablePrompts,
+            disableNames: options.disablePrompts,
+            enableAll: options.enableAllPrompts,
+            disableAll: options.disableAllPrompts,
+        });
+    }
+    // Apply resource changes
+    if (options.enableResources || options.disableResources || options.enableAllResources || options.disableAllResources) {
+        updateFeatures(config, 'resources', {
+            enableNames: options.enableResources,
+            disableNames: options.disableResources,
+            enableAll: options.enableAllResources,
+            disableAll: options.disableAllResources,
+        });
+    }
+    writeConfig(projectPath, config);
+    console.log('Configuration updated successfully.');
+});
+//# sourceMappingURL=configure.js.map

package/dist/commands/configure.js.map

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

package/dist/commands/connect.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const connectCommand: Command;

package/dist/commands/connect.js

@@ -0,0 +1,64 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import { findEditorPath, getProjectEditorVersion, launchEditor } from '../utils/unity-editor.js';
+export const connectCommand = new Command('connect')
+    .description('Open Unity and enforce MCP connection to a specified server URL via environment variables')
+    .requiredOption('--project-path <path>', 'Path to the Unity project')
+    .requiredOption('--url <url>', 'MCP server URL to connect to')
+    .option('--tools <names>', 'Comma-separated list of tools to enable (sets UNITY_MCP_TOOLS)')
+    .option('--token <token>', 'Auth token (sets UNITY_MCP_TOKEN)')
+    .option('--auth <option>', 'Auth option: none or required (sets UNITY_MCP_AUTH_OPTION)')
+    .option('--keep-connected', 'Force keep connected (sets UNITY_MCP_KEEP_CONNECTED=true)')
+    .option('--editor-version <version>', 'Specific Unity Editor version to use')
+    .action(async (options) => {
+    const projectPath = path.resolve(options.projectPath);
+    if (!fs.existsSync(projectPath)) {
+        console.error(`Error: Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    // Determine editor version
+    let version = options.editorVersion;
+    if (!version) {
+        version = getProjectEditorVersion(projectPath) ?? undefined;
+        if (version) {
+            console.log(`Detected editor version from project: ${version}`);
+        }
+    }
+    const editorPath = findEditorPath(version);
+    if (!editorPath) {
+        const versionMsg = version ? ` (version ${version})` : '';
+        console.error(`Error: Unity Editor not found${versionMsg}. Install it with: unity-mcp install-editor --version <version>`);
+        process.exit(1);
+    }
+    // Build environment variables for MCP connection
+    const env = {
+        UNITY_MCP_HOST: options.url,
+    };
+    if (options.keepConnected) {
+        env['UNITY_MCP_KEEP_CONNECTED'] = 'true';
+    }
+    if (options.tools) {
+        env['UNITY_MCP_TOOLS'] = options.tools;
+    }
+    if (options.token) {
+        env['UNITY_MCP_TOKEN'] = options.token;
+    }
+    if (options.auth) {
+        if (options.auth !== 'none' && options.auth !== 'required') {
+            console.error('Error: --auth must be "none" or "required"');
+            process.exit(1);
+        }
+        env['UNITY_MCP_AUTH_OPTION'] = options.auth;
+    }
+    console.log(`Connecting to MCP server: ${options.url}`);
+    console.log('Environment variables:');
+    for (const [key, value] of Object.entries(env)) {
+        const display = key === 'UNITY_MCP_TOKEN' ? '***' : value;
+        console.log(`  ${key}=${display}`);
+    }
+    console.log(`\nOpening project: ${projectPath}`);
+    console.log(`Using editor: ${editorPath}`);
+    launchEditor(editorPath, projectPath, env);
+});
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

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

package/dist/commands/create-project.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const createProjectCommand: Command;

package/dist/commands/create-project.js

@@ -0,0 +1,28 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import { findUnityHub, createProject, listInstalledEditors } from '../utils/unity-hub.js';
+export const createProjectCommand = new Command('create-project')
+    .description('Create a new Unity project')
+    .requiredOption('--path <path>', 'Path where the project will be created')
+    .option('--editor-version <version>', 'Unity Editor version to use')
+    .action(async (options) => {
+    const hubPath = findUnityHub();
+    if (!hubPath) {
+        console.error('Error: Unity Hub not found. Please install Unity Hub first.');
+        process.exit(1);
+    }
+    let editorVersion = options.editorVersion;
+    if (!editorVersion) {
+        // Use the latest installed editor
+        const editors = listInstalledEditors(hubPath);
+        if (editors.length === 0) {
+            console.error('Error: No Unity editors installed. Install one with: unity-mcp install-editor --version <version>');
+            process.exit(1);
+        }
+        editorVersion = editors[0].version;
+        console.log(`No editor version specified, using latest installed: ${editorVersion}`);
+    }
+    const projectPath = path.resolve(options.path);
+    createProject(hubPath, projectPath, editorVersion);
+});
+//# sourceMappingURL=create-project.js.map

package/dist/commands/create-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project.js","sourceRoot":"","sources":["../../src/commands/create-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE1F,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KAC9D,WAAW,CAAC,4BAA4B,CAAC;KACzC,cAAc,CAAC,eAAe,EAAE,wCAAwC,CAAC;KACzE,MAAM,CAAC,4BAA4B,EAAE,6BAA6B,CAAC;KACnE,MAAM,CAAC,KAAK,EAAE,OAAiD,EAAE,EAAE;IAClE,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE1C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,kCAAkC;QAClC,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,mGAAmG,CAAC,CAAC;YACnH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,wDAAwD,aAAa,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC"}

package/dist/commands/install-editor.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const installEditorCommand: Command;

package/dist/commands/install-editor.js

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+import { findUnityHub, installEditor, listInstalledEditors } from '../utils/unity-hub.js';
+import { getProjectEditorVersion } from '../utils/unity-editor.js';
+export const installEditorCommand = new Command('install-editor')
+    .description('Install Unity Editor via Unity Hub')
+    .option('--version <version>', 'Unity Editor version to install')
+    .option('--project-path <path>', 'Read version from an existing Unity project')
+    .action(async (options) => {
+    const hubPath = findUnityHub();
+    if (!hubPath) {
+        console.error('Error: Unity Hub not found. Please install Unity Hub first.');
+        process.exit(1);
+    }
+    let version = options.version;
+    if (!version && options.projectPath) {
+        version = getProjectEditorVersion(options.projectPath) ?? undefined;
+        if (version) {
+            console.log(`Detected editor version from project: ${version}`);
+        }
+        else {
+            console.error('Error: Could not read editor version from ProjectSettings/ProjectVersion.txt');
+            process.exit(1);
+        }
+    }
+    if (!version) {
+        console.error('Error: Please specify --version or --project-path');
+        // Show installed editors as a hint
+        const editors = listInstalledEditors(hubPath);
+        if (editors.length > 0) {
+            console.log('\nCurrently installed editors:');
+            for (const editor of editors) {
+                console.log(`  ${editor.version} - ${editor.path}`);
+            }
+        }
+        process.exit(1);
+    }
+    // Check if already installed
+    const editors = listInstalledEditors(hubPath);
+    const alreadyInstalled = editors.find((e) => e.version === version);
+    if (alreadyInstalled) {
+        console.log(`Unity Editor ${version} is already installed at: ${alreadyInstalled.path}`);
+        return;
+    }
+    installEditor(hubPath, version);
+});
+//# sourceMappingURL=install-editor.js.map

package/dist/commands/install-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-editor.js","sourceRoot":"","sources":["../../src/commands/install-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KAC9D,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,qBAAqB,EAAE,iCAAiC,CAAC;KAChE,MAAM,CAAC,uBAAuB,EAAE,6CAA6C,CAAC;KAC9E,MAAM,CAAC,KAAK,EAAE,OAAmD,EAAE,EAAE;IACpE,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,GAAG,uBAAuB,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;QACpE,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;YAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAEnE,mCAAmC;QACnC,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAC9C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,OAAO,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6BAA6B;IAC7B,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACpE,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO,6BAA6B,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;QACzF,OAAO;IACT,CAAC;IAED,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC"}

package/dist/commands/install-plugin.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const installPluginCommand: Command;

package/dist/commands/install-plugin.js

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import { addPluginToManifest, resolveLatestVersion } from '../utils/manifest.js';
+export const installPluginCommand = new Command('install-plugin')
+    .description('Install Unity-MCP plugin into a Unity project')
+    .requiredOption('--project-path <path>', 'Path to the Unity project')
+    .option('--plugin-version <version>', 'Plugin version to install (default: latest)')
+    .action(async (options) => {
+    const projectPath = path.resolve(options.projectPath);
+    // Validate project exists
+    const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        console.error(`Error: Not a valid Unity project (missing Packages/manifest.json): ${projectPath}`);
+        process.exit(1);
+    }
+    // Resolve version
+    let version = options.pluginVersion;
+    if (!version) {
+        version = await resolveLatestVersion();
+    }
+    console.log(`Installing Unity-MCP plugin v${version} into: ${projectPath}`);
+    addPluginToManifest(projectPath, version);
+    console.log('Done! Open the project in Unity Editor to complete installation.');
+});
+//# sourceMappingURL=install-plugin.js.map

package/dist/commands/install-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-plugin.js","sourceRoot":"","sources":["../../src/commands/install-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;KAC9D,WAAW,CAAC,+CAA+C,CAAC;KAC5D,cAAc,CAAC,uBAAuB,EAAE,2BAA2B,CAAC;KACpE,MAAM,CAAC,4BAA4B,EAAE,6CAA6C,CAAC;KACnF,MAAM,CAAC,KAAK,EAAE,OAAwD,EAAE,EAAE;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEtD,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;IACzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,sEAAsE,WAAW,EAAE,CAAC,CAAC;QACnG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gCAAgC,OAAO,UAAU,WAAW,EAAE,CAAC,CAAC;IAC5E,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC"}

package/dist/commands/open.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const openCommand: Command;

package/dist/commands/open.js

@@ -0,0 +1,33 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import { findEditorPath, getProjectEditorVersion, launchEditor } from '../utils/unity-editor.js';
+export const openCommand = new Command('open')
+    .description('Open a Unity project in Unity Editor')
+    .requiredOption('--project-path <path>', 'Path to the Unity project')
+    .option('--editor-version <version>', 'Specific Unity Editor version to use')
+    .action(async (options) => {
+    const projectPath = path.resolve(options.projectPath);
+    if (!fs.existsSync(projectPath)) {
+        console.error(`Error: Project path does not exist: ${projectPath}`);
+        process.exit(1);
+    }
+    // Determine editor version
+    let version = options.editorVersion;
+    if (!version) {
+        version = getProjectEditorVersion(projectPath) ?? undefined;
+        if (version) {
+            console.log(`Detected editor version from project: ${version}`);
+        }
+    }
+    const editorPath = findEditorPath(version);
+    if (!editorPath) {
+        const versionMsg = version ? ` (version ${version})` : '';
+        console.error(`Error: Unity Editor not found${versionMsg}. Install it with: unity-mcp install-editor --version <version>`);
+        process.exit(1);
+    }
+    console.log(`Opening project: ${projectPath}`);
+    console.log(`Using editor: ${editorPath}`);
+    launchEditor(editorPath, projectPath);
+});
+//# sourceMappingURL=open.js.map

package/dist/commands/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/commands/open.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEjG,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,sCAAsC,CAAC;KACnD,cAAc,CAAC,uBAAuB,EAAE,2BAA2B,CAAC;KACpE,MAAM,CAAC,4BAA4B,EAAE,sCAAsC,CAAC;KAC5E,MAAM,CAAC,KAAK,EAAE,OAAwD,EAAE,EAAE;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAEtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,uCAAuC,WAAW,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC;QAC5D,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,yCAAyC,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,gCAAgC,UAAU,iEAAiE,CAAC,CAAC;QAC3H,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAC3C,YAAY,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import { createRequire } from 'module';
+import { createProjectCommand } from './commands/create-project.js';
+import { installEditorCommand } from './commands/install-editor.js';
+import { openCommand } from './commands/open.js';
+import { installPluginCommand } from './commands/install-plugin.js';
+import { configureCommand } from './commands/configure.js';
+import { connectCommand } from './commands/connect.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+const program = new Command();
+program
+    .name('unity-mcp')
+    .description('Cross-platform CLI tool for Unity-MCP operations')
+    .version(pkg.version);
+program.addCommand(createProjectCommand);
+program.addCommand(installEditorCommand);
+program.addCommand(openCommand);
+program.addCommand(installPluginCommand);
+program.addCommand(configureCommand);
+program.addCommand(connectCommand);
+program.parseAsync().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,kDAAkD,CAAC;KAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;AACrC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AAEnC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,51 @@
+export interface McpFeature {
+    name: string;
+    enabled: boolean;
+}
+export interface UnityConnectionConfig {
+    host?: string;
+    token?: string;
+    keepConnected?: boolean;
+    logLevel?: number;
+    timeoutMs?: number;
+    keepServerRunning?: boolean;
+    transportMethod?: string;
+    authOption?: string;
+    connectionMode?: string;
+    cloudServerUrl?: string;
+    cloudToken?: string;
+    tools?: McpFeature[];
+    prompts?: McpFeature[];
+    resources?: McpFeature[];
+    [key: string]: unknown;
+}
+/**
+ * Create a default config for a Unity project.
+ */
+export declare function createDefaultConfig(projectPath: string): UnityConnectionConfig;
+/**
+ * Read the AI-Game-Developer-Config.json from a Unity project.
+ * Returns null if the file doesn't exist.
+ */
+export declare function readConfig(projectPath: string): UnityConnectionConfig | null;
+/**
+ * Write the AI-Game-Developer-Config.json to a Unity project.
+ * Creates the UserSettings directory if needed.
+ */
+export declare function writeConfig(projectPath: string, config: UnityConnectionConfig): void;
+/**
+ * Read config or create with defaults if it doesn't exist.
+ */
+export declare function getOrCreateConfig(projectPath: string): UnityConnectionConfig;
+/**
+ * Update features (tools, prompts, or resources) in the config.
+ * - enableNames: set these to enabled=true
+ * - disableNames: set these to enabled=false
+ * - enableAll/disableAll: override all features
+ */
+export declare function updateFeatures(config: UnityConnectionConfig, featureType: 'tools' | 'prompts' | 'resources', options: {
+    enableNames?: string[];
+    disableNames?: string[];
+    enableAll?: boolean;
+    disableAll?: boolean;
+}): void;

package/dist/utils/config.js

@@ -0,0 +1,118 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { generatePortFromDirectory } from './port.js';
+const CONFIG_RELATIVE_PATH = 'UserSettings/AI-Game-Developer-Config.json';
+function getConfigPath(projectPath) {
+    return path.join(projectPath, CONFIG_RELATIVE_PATH);
+}
+/**
+ * Create a default config for a Unity project.
+ */
+export function createDefaultConfig(projectPath) {
+    const port = generatePortFromDirectory(projectPath);
+    return {
+        host: `http://localhost:${port}`,
+        keepConnected: false,
+        logLevel: 3,
+        timeoutMs: 10000,
+        keepServerRunning: false,
+        transportMethod: 'streamableHttp',
+        authOption: 'none',
+        connectionMode: 'Custom',
+        cloudServerUrl: 'https://ai-game.dev',
+        tools: [],
+        prompts: [],
+        resources: [],
+    };
+}
+/**
+ * Read the AI-Game-Developer-Config.json from a Unity project.
+ * Returns null if the file doesn't exist.
+ */
+export function readConfig(projectPath) {
+    const configPath = getConfigPath(projectPath);
+    if (!fs.existsSync(configPath)) {
+        return null;
+    }
+    const json = fs.readFileSync(configPath, 'utf-8');
+    try {
+        return JSON.parse(json);
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            console.error(`Malformed JSON in config file: ${configPath}\n${err.message}`);
+        }
+        return null;
+    }
+}
+/**
+ * Write the AI-Game-Developer-Config.json to a Unity project.
+ * Creates the UserSettings directory if needed.
+ */
+export function writeConfig(projectPath, config) {
+    const configPath = getConfigPath(projectPath);
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * Read config or create with defaults if it doesn't exist.
+ */
+export function getOrCreateConfig(projectPath) {
+    const existing = readConfig(projectPath);
+    if (existing)
+        return existing;
+    const config = createDefaultConfig(projectPath);
+    writeConfig(projectPath, config);
+    return config;
+}
+/**
+ * Update features (tools, prompts, or resources) in the config.
+ * - enableNames: set these to enabled=true
+ * - disableNames: set these to enabled=false
+ * - enableAll/disableAll: override all features
+ */
+export function updateFeatures(config, featureType, options) {
+    const rawFeatures = config[featureType];
+    const features = Array.isArray(rawFeatures)
+        ? rawFeatures.filter((f) => typeof f === 'object' && f !== null && typeof f.name === 'string' && typeof f.enabled === 'boolean')
+        : [];
+    if (options.enableAll) {
+        for (const f of features)
+            f.enabled = true;
+        config[featureType] = features;
+        return;
+    }
+    if (options.disableAll) {
+        for (const f of features)
+            f.enabled = false;
+        config[featureType] = features;
+        return;
+    }
+    if (options.enableNames) {
+        for (const name of options.enableNames) {
+            const existing = features.find((f) => f.name === name);
+            if (existing) {
+                existing.enabled = true;
+            }
+            else {
+                features.push({ name, enabled: true });
+            }
+        }
+    }
+    if (options.disableNames) {
+        for (const name of options.disableNames) {
+            const existing = features.find((f) => f.name === name);
+            if (existing) {
+                existing.enabled = false;
+            }
+            else {
+                features.push({ name, enabled: false });
+            }
+        }
+    }
+    config[featureType] = features;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/manifest.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolve the latest plugin version. Tries OpenUPM API first, falls back to hardcoded version.
+ */
+export declare function resolveLatestVersion(): Promise<string>;
+/**
+ * Determines if the version should be updated.
+ * Only update if the new version is higher than the current version.
+ * Ports the C# Installer.ShouldUpdateVersion() logic.
+ */
+export declare function shouldUpdateVersion(currentVersion: string, newVersion: string): boolean;
+/**
+ * Add Unity-MCP plugin to a Unity project's Packages/manifest.json.
+ * Ports the C# Installer.Manifest.cs logic:
+ * - Adds OpenUPM scoped registry with required scopes
+ * - Adds/updates the plugin dependency (never downgrades)
+ */
+export declare function addPluginToManifest(projectPath: string, version: string): void;

package/dist/utils/manifest.js

@@ -0,0 +1,134 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import semver from 'semver';
+const PACKAGE_ID = 'com.ivanmurzak.unity.mcp';
+const REGISTRY_NAME = 'package.openupm.com';
+const REGISTRY_URL = 'https://package.openupm.com';
+const REQUIRED_SCOPES = [
+    'com.ivanmurzak',
+    'extensions.unity',
+    'org.nuget.com.ivanmurzak',
+    'org.nuget.microsoft',
+    'org.nuget.system',
+    'org.nuget.r3',
+];
+// Hardcoded fallback version (updated on each release)
+const FALLBACK_VERSION = '0.51.6';
+/**
+ * Resolve the latest plugin version. Tries OpenUPM API first, falls back to hardcoded version.
+ */
+export async function resolveLatestVersion() {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        try {
+            const res = await fetch(`https://package.openupm.com/${PACKAGE_ID}`, {
+                signal: controller.signal,
+                headers: { Accept: 'application/json' },
+            });
+            if (res.ok) {
+                const data = (await res.json());
+                const latest = data?.['dist-tags']?.latest;
+                if (latest) {
+                    console.log(`Resolved latest version from OpenUPM: ${latest}`);
+                    return latest;
+                }
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    catch {
+        // Network error or timeout — fall through to hardcoded version
+    }
+    console.log(`Using fallback version: ${FALLBACK_VERSION}`);
+    return FALLBACK_VERSION;
+}
+/**
+ * Determines if the version should be updated.
+ * Only update if the new version is higher than the current version.
+ * Ports the C# Installer.ShouldUpdateVersion() logic.
+ */
+export function shouldUpdateVersion(currentVersion, newVersion) {
+    if (!currentVersion)
+        return true;
+    if (!newVersion)
+        return false;
+    // Skip automatic update for non-semver specs (file:, git+, http, etc.)
+    const nonSemverPrefixes = ['file:', 'git+', 'http:', 'https:'];
+    if (nonSemverPrefixes.some((prefix) => currentVersion.startsWith(prefix))) {
+        return false;
+    }
+    const current = semver.valid(semver.coerce(currentVersion));
+    const target = semver.valid(semver.coerce(newVersion));
+    if (current && target) {
+        return semver.gt(target, current);
+    }
+    // Fallback to string comparison
+    return newVersion.localeCompare(currentVersion) > 0;
+}
+/**
+ * Add Unity-MCP plugin to a Unity project's Packages/manifest.json.
+ * Ports the C# Installer.Manifest.cs logic:
+ * - Adds OpenUPM scoped registry with required scopes
+ * - Adds/updates the plugin dependency (never downgrades)
+ */
+export function addPluginToManifest(projectPath, version) {
+    const manifestPath = path.join(projectPath, 'Packages', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error(`manifest.json not found at: ${manifestPath}`);
+    }
+    const rawJson = fs.readFileSync(manifestPath, 'utf-8');
+    const manifest = JSON.parse(rawJson);
+    let modified = false;
+    // --- Ensure scopedRegistries array exists
+    if (!manifest.scopedRegistries) {
+        manifest.scopedRegistries = [];
+        modified = true;
+    }
+    // --- Find or create the OpenUPM registry
+    let openUpmRegistry = manifest.scopedRegistries.find((r) => r.name === REGISTRY_NAME);
+    if (!openUpmRegistry) {
+        openUpmRegistry = {
+            name: REGISTRY_NAME,
+            url: REGISTRY_URL,
+            scopes: [],
+        };
+        manifest.scopedRegistries.push(openUpmRegistry);
+        modified = true;
+    }
+    // --- Add missing scopes
+    if (!openUpmRegistry.scopes) {
+        openUpmRegistry.scopes = [];
+        modified = true;
+    }
+    for (const scope of REQUIRED_SCOPES) {
+        if (!openUpmRegistry.scopes.includes(scope)) {
+            openUpmRegistry.scopes.push(scope);
+            modified = true;
+        }
+    }
+    // --- Add/update dependency (version-aware, never downgrade)
+    if (!manifest.dependencies) {
+        manifest.dependencies = {};
+        modified = true;
+    }
+    const currentVersion = manifest.dependencies[PACKAGE_ID];
+    if (!currentVersion || shouldUpdateVersion(currentVersion, version)) {
+        manifest.dependencies[PACKAGE_ID] = version;
+        modified = true;
+    }
+    else {
+        console.log(`Plugin already at version ${currentVersion} (>= ${version}). Skipping version update.`);
+    }
+    // --- Write back
+    if (modified) {
+        fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+        console.log(`Updated ${manifestPath}`);
+    }
+    else {
+        console.log('manifest.json is already up to date.');
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/utils/manifest.js.map

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

package/dist/utils/port.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generate a deterministic port from a directory path.
+ * Ports the C# UnityMcpPlugin.GeneratePortFromDirectory() logic.
+ * SHA256 hash of lowercased directory → first 4 bytes as uint32 → modulo 10000 + 50000.
+ */
+export declare function generatePortFromDirectory(dir: string): number;

package/dist/utils/port.js

@@ -0,0 +1,19 @@
+import { createHash } from 'crypto';
+const MIN_PORT = 50000;
+const MAX_PORT = 59999;
+const PORT_RANGE = MAX_PORT - MIN_PORT + 1;
+/**
+ * Generate a deterministic port from a directory path.
+ * Ports the C# UnityMcpPlugin.GeneratePortFromDirectory() logic.
+ * SHA256 hash of lowercased directory → first 4 bytes as uint32 → modulo 10000 + 50000.
+ */
+export function generatePortFromDirectory(dir) {
+    const hash = createHash('sha256')
+        .update(dir.toLowerCase())
+        .digest();
+    // Read first 4 bytes as little-endian int32, then treat as unsigned
+    const int32 = hash.readInt32LE(0);
+    const uint32 = int32 >>> 0;
+    return MIN_PORT + (uint32 % PORT_RANGE);
+}
+//# sourceMappingURL=port.js.map

package/dist/utils/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/utils/port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,QAAQ,GAAG,KAAK,CAAC;AACvB,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;SACzB,MAAM,EAAE,CAAC;IAEZ,oEAAoE;IACpE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,KAAK,CAAC,CAAC;IAE3B,OAAO,QAAQ,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;AAC1C,CAAC"}

package/dist/utils/unity-editor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Read the Unity editor version from a project's ProjectSettings/ProjectVersion.txt.
+ */
+export declare function getProjectEditorVersion(projectPath: string): string | null;
+/**
+ * Find the Unity Editor binary path for a specific version.
+ * Uses Unity Hub to locate installed editors.
+ */
+export declare function findEditorPath(version?: string): string | null;
+/**
+ * Launch Unity Editor with the given project path.
+ * Spawns a detached process and returns immediately.
+ */
+export declare function launchEditor(editorPath: string, projectPath: string, env?: Record<string, string>): void;

package/dist/utils/unity-editor.js

@@ -0,0 +1,180 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn } from 'child_process';
+import { platform } from 'os';
+import { findUnityHub, listInstalledEditors } from './unity-hub.js';
+/**
+ * Compare two Unity version strings with numeric-aware sorting.
+ * Parses components like "2022.3.62f3" into [2022, 3, 62, "f", 3].
+ * Returns negative if a < b, positive if a > b, 0 if equal.
+ */
+function compareUnityVersions(a, b) {
+    const parseVersion = (v) => {
+        const parts = [];
+        for (const segment of v.split(/([.\-])/)) {
+            // Split each segment further into numeric and alpha tokens
+            const tokens = segment.match(/(\d+|[a-zA-Z]+)/g);
+            if (tokens) {
+                for (const token of tokens) {
+                    const num = parseInt(token, 10);
+                    parts.push(isNaN(num) ? token : num);
+                }
+            }
+        }
+        return parts;
+    };
+    const aParts = parseVersion(a);
+    const bParts = parseVersion(b);
+    const len = Math.max(aParts.length, bParts.length);
+    for (let i = 0; i < len; i++) {
+        const ap = aParts[i];
+        const bp = bParts[i];
+        if (ap === undefined && bp === undefined)
+            return 0;
+        if (ap === undefined)
+            return -1;
+        if (bp === undefined)
+            return 1;
+        if (typeof ap === 'number' && typeof bp === 'number') {
+            if (ap !== bp)
+                return ap - bp;
+        }
+        else {
+            const cmp = String(ap).localeCompare(String(bp));
+            if (cmp !== 0)
+                return cmp;
+        }
+    }
+    return 0;
+}
+/**
+ * Read the Unity editor version from a project's ProjectSettings/ProjectVersion.txt.
+ */
+export function getProjectEditorVersion(projectPath) {
+    const versionFile = path.join(projectPath, 'ProjectSettings', 'ProjectVersion.txt');
+    if (!fs.existsSync(versionFile)) {
+        return null;
+    }
+    const content = fs.readFileSync(versionFile, 'utf-8');
+    const match = content.match(/m_EditorVersion:\s*(.+)/);
+    return match ? match[1].trim() : null;
+}
+/**
+ * Find the Unity Editor binary path for a specific version.
+ * Uses Unity Hub to locate installed editors.
+ */
+export function findEditorPath(version) {
+    const hubPath = findUnityHub();
+    if (!hubPath) {
+        // Try common default locations
+        return findEditorPathByCommonLocations(version);
+    }
+    const editors = listInstalledEditors(hubPath);
+    if (editors.length === 0) {
+        return findEditorPathByCommonLocations(version);
+    }
+    if (version) {
+        const match = editors.find((e) => e.version === version);
+        if (match)
+            return getEditorBinary(match.path);
+    }
+    // Return the latest editor by version-aware sorting
+    const sorted = [...editors].sort((a, b) => compareUnityVersions(b.version, a.version));
+    return getEditorBinary(sorted[0].path);
+}
+/**
+ * Find editor by checking common installation directories.
+ */
+function findEditorPathByCommonLocations(version) {
+    const os = platform();
+    const candidates = [];
+    switch (os) {
+        case 'win32': {
+            const programFiles = process.env['PROGRAMFILES'] ?? 'C:\\Program Files';
+            if (version) {
+                candidates.push(path.join(programFiles, 'Unity', 'Hub', 'Editor', version, 'Editor', 'Unity.exe'));
+            }
+            // Check for any editor
+            const hubEditorDir = path.join(programFiles, 'Unity', 'Hub', 'Editor');
+            if (fs.existsSync(hubEditorDir)) {
+                try {
+                    const versions = fs.readdirSync(hubEditorDir).sort((a, b) => compareUnityVersions(b, a));
+                    for (const v of versions) {
+                        candidates.push(path.join(hubEditorDir, v, 'Editor', 'Unity.exe'));
+                    }
+                }
+                catch { /* ignore */ }
+            }
+            break;
+        }
+        case 'darwin': {
+            if (version) {
+                candidates.push(`/Applications/Unity/Hub/Editor/${version}/Unity.app/Contents/MacOS/Unity`);
+            }
+            const hubEditorDir = '/Applications/Unity/Hub/Editor';
+            if (fs.existsSync(hubEditorDir)) {
+                try {
+                    const versions = fs.readdirSync(hubEditorDir).sort((a, b) => compareUnityVersions(b, a));
+                    for (const v of versions) {
+                        candidates.push(path.join(hubEditorDir, v, 'Unity.app', 'Contents', 'MacOS', 'Unity'));
+                    }
+                }
+                catch { /* ignore */ }
+            }
+            break;
+        }
+        case 'linux': {
+            if (version) {
+                candidates.push(`/opt/unity/hub/Editor/${version}/Editor/Unity`);
+                candidates.push(path.join(process.env['HOME'] ?? '', 'Unity', 'Hub', 'Editor', version, 'Editor', 'Unity'));
+            }
+            for (const baseDir of ['/opt/unity/hub/Editor', path.join(process.env['HOME'] ?? '', 'Unity', 'Hub', 'Editor')]) {
+                if (fs.existsSync(baseDir)) {
+                    try {
+                        const versions = fs.readdirSync(baseDir).sort((a, b) => compareUnityVersions(b, a));
+                        for (const v of versions) {
+                            candidates.push(path.join(baseDir, v, 'Editor', 'Unity'));
+                        }
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+            break;
+        }
+    }
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Get the Unity binary path from an editor installation directory.
+ */
+function getEditorBinary(editorDir) {
+    const os = platform();
+    switch (os) {
+        case 'win32':
+            return path.join(editorDir, 'Editor', 'Unity.exe');
+        case 'darwin':
+            return path.join(editorDir, 'Unity.app', 'Contents', 'MacOS', 'Unity');
+        default:
+            return path.join(editorDir, 'Editor', 'Unity');
+    }
+}
+/**
+ * Launch Unity Editor with the given project path.
+ * Spawns a detached process and returns immediately.
+ */
+export function launchEditor(editorPath, projectPath, env) {
+    const args = ['-projectPath', path.resolve(projectPath)];
+    const child = spawn(editorPath, args, {
+        detached: true,
+        stdio: 'ignore',
+        env: { ...process.env, ...env },
+    });
+    child.unref();
+    console.log(`Launched Unity Editor (PID: ${child.pid})`);
+}
+//# sourceMappingURL=unity-editor.js.map

package/dist/utils/unity-editor.js.map

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

package/dist/utils/unity-hub.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Detect the Unity Hub installation path based on the current platform.
+ * Returns the path if found, or null.
+ */
+export declare function findUnityHub(): string | null;
+export interface InstalledEditor {
+    version: string;
+    path: string;
+}
+/**
+ * List installed Unity editors via Unity Hub CLI.
+ */
+export declare function listInstalledEditors(hubPath: string): InstalledEditor[];
+/**
+ * Install a Unity editor version via Unity Hub CLI.
+ */
+export declare function installEditor(hubPath: string, version: string): void;
+/**
+ * Create a new Unity project via Unity Hub CLI.
+ */
+export declare function createProject(hubPath: string, projectPath: string, editorVersion?: string): void;

package/dist/utils/unity-hub.js

@@ -0,0 +1,90 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { execFileSync } from 'child_process';
+import { platform } from 'os';
+/**
+ * Detect the Unity Hub installation path based on the current platform.
+ * Returns the path if found, or null.
+ */
+export function findUnityHub() {
+    const os = platform();
+    const candidates = [];
+    switch (os) {
+        case 'win32':
+            candidates.push(path.join(process.env['PROGRAMFILES'] ?? 'C:\\Program Files', 'Unity Hub', 'Unity Hub.exe'), path.join(process.env['LOCALAPPDATA'] ?? '', 'Programs', 'Unity Hub', 'Unity Hub.exe'));
+            break;
+        case 'darwin':
+            candidates.push('/Applications/Unity Hub.app/Contents/MacOS/Unity Hub');
+            break;
+        case 'linux':
+            candidates.push('/usr/bin/unity-hub', '/snap/bin/unity-hub', path.join(process.env['HOME'] ?? '', 'Applications', 'Unity Hub.AppImage'));
+            break;
+    }
+    for (const candidate of candidates) {
+        if (candidate && fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * List installed Unity editors via Unity Hub CLI.
+ */
+export function listInstalledEditors(hubPath) {
+    try {
+        const output = execFileSync(hubPath, ['--', '--headless', 'editors', '--installed'], {
+            encoding: 'utf-8',
+            timeout: 30000,
+        });
+        const editors = [];
+        for (const line of output.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            // Format: "2022.3.62f3 , installed at /path/to/editor"
+            const match = trimmed.match(/^([\d.]+\w*)\s*,?\s*installed at\s+(.+)$/i);
+            if (match) {
+                editors.push({ version: match[1], path: match[2].trim() });
+            }
+        }
+        return editors;
+    }
+    catch (err) {
+        console.error('Failed to list installed editors:', err.message);
+        return [];
+    }
+}
+/**
+ * Install a Unity editor version via Unity Hub CLI.
+ */
+export function installEditor(hubPath, version) {
+    console.log(`Installing Unity Editor ${version} via Unity Hub...`);
+    try {
+        execFileSync(hubPath, ['--', '--headless', 'install', '--version', version], { encoding: 'utf-8', timeout: 600000, stdio: 'inherit' });
+    }
+    catch (err) {
+        throw new Error(`Failed to install Unity Editor ${version}: ${err.message}`);
+    }
+}
+/**
+ * Create a new Unity project via Unity Hub CLI.
+ */
+export function createProject(hubPath, projectPath, editorVersion) {
+    const args = ['--', '--headless', 'create', '-projectPath', projectPath];
+    if (editorVersion) {
+        args.push('-version', editorVersion);
+    }
+    console.log(`Creating Unity project at: ${projectPath}`);
+    try {
+        execFileSync(hubPath, args, {
+            encoding: 'utf-8',
+            timeout: 120000,
+            stdio: 'inherit',
+        });
+        console.log('Project created successfully.');
+    }
+    catch (err) {
+        throw new Error(`Failed to create project: ${err.message}`);
+    }
+}
+//# sourceMappingURL=unity-hub.js.map

package/dist/utils/unity-hub.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "unity-mcp-cli",
+  "version": "0.51.6",
+  "description": "Cross-platform CLI tool for Unity-MCP operations — create projects, install plugins, configure tools, and manage MCP connections",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "unity-mcp": "bin/unity-mcp.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "pretest": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "unity",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "cli"
+  ],
+  "author": "Ivan Murzak",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/IvanMurzak/Unity-MCP.git",
+    "directory": "cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "semver": "^7.7.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@types/semver": "^7.7.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.1.0"
+  }
+}