@mseep/anklebreaker-unity-mcp 2.30.0

package/manifest.json

@@ -0,0 +1,178 @@
+{
+  "manifest_version": "0.3",
+  "name": "unity-mcp",
+  "display_name": "AnkleBreaker Unity MCP",
+  "version": "2.18.0",
+  "description": "Multi-agent MCP server for Unity Editor — 259 tools (66 core + 193 advanced via two-tier system) across 24 categories with multi-instance support. Designed for Claude Cowork with async queue and fair scheduling across agents.",
+  "long_description": "AnkleBreaker Unity MCP connects Claude to your Unity Editor with 259 tools across 24 categories. Built for Claude Cowork's multi-agent architecture, where multiple AI agents collaborate on the same Unity project in parallel.\n\n**Key features:**\n- 259 tools via two-tier system: 66 core tools always available + 193 advanced tools on-demand via unity_advanced_tool\n- Two-tier architecture keeps MCP payload under 32KB for reliable client registration\n- Multi-instance support: run multiple Unity Editors simultaneously, auto-port selection (7890–7899), shared instance registry\n- ParrelSync clone detection for multiplayer development workflows\n- Multi-agent async queue with fair round-robin scheduling\n- Read batching (up to 5/frame) and write serialization (1/frame)\n- Agent session tracking and action logging\n- Project Context auto-injection for project-aware AI assistance\n- Automatic fallback to legacy sync mode for older plugin versions\n\n**Requires the companion Unity Editor plugin:** Install via Unity Package Manager → Add package from git URL → `https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.git`\n\nAfter installing the plugin, open Window → AB Unity MCP in Unity and verify the bridge is running.",
+  "author": {
+    "name": "AnkleBreaker Studio",
+    "email": "francois@anklebreaker-studio.com",
+    "url": "https://anklebreaker-studio.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AnkleBreaker-Studio/unity-mcp-server.git"
+  },
+  "homepage": "https://github.com/AnkleBreaker-Studio/unity-mcp-server",
+  "documentation": "https://github.com/AnkleBreaker-Studio/unity-mcp-server/blob/main/README.md",
+  "support": "https://github.com/AnkleBreaker-Studio/unity-mcp-server/issues",
+  "icon": "icon.png",
+  "license": "MIT",
+  "keywords": [
+    "unity",
+    "unity3d",
+    "game-development",
+    "editor",
+    "scenes",
+    "gameobjects",
+    "scripts",
+    "builds",
+    "profiling",
+    "multi-agent",
+    "multi-instance",
+    "parrelsync",
+    "cowork"
+  ],
+  "privacy_policies": [],
+  "compatibility": {
+    "claude_desktop": ">=1.0.0",
+    "platforms": [
+      "win32",
+      "darwin"
+    ],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  },
+  "server": {
+    "type": "node",
+    "entry_point": "src/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/src/index.js"
+      ],
+      "env": {
+        "UNITY_HUB_PATH": "${user_config.unity_hub_path}",
+        "UNITY_BRIDGE_PORT": "${user_config.bridge_port}"
+      },
+      "platform_overrides": {
+        "darwin": {
+          "env": {
+            "UNITY_HUB_PATH": "${user_config.unity_hub_path}"
+          }
+        }
+      }
+    }
+  },
+  "user_config": {
+    "unity_hub_path": {
+      "type": "file",
+      "title": "Unity Hub Path",
+      "description": "Path to Unity Hub executable. On Windows: C:\\Program Files\\Unity Hub\\Unity Hub.exe — On macOS: /Applications/Unity Hub.app/Contents/MacOS/Unity Hub",
+      "required": false,
+      "default": "C:\\Program Files\\Unity Hub\\Unity Hub.exe"
+    },
+    "bridge_port": {
+      "type": "string",
+      "title": "Bridge Port",
+      "description": "Default port for the Unity Editor plugin. With multi-instance support (v2.15.0+), ports are auto-discovered from the instance registry. Only used as fallback. Default: 7890",
+      "required": false,
+      "default": "7890"
+    }
+  },
+  "tools_generated": true,
+  "tools": [
+    { "name": "unity_list_instances", "description": "List all running Unity Editor instances with project info" },
+    { "name": "unity_select_instance", "description": "Select which Unity Editor instance to target" },
+    { "name": "unity_hub_list_editors", "description": "List installed Unity Editor versions" },
+    { "name": "unity_hub_install_editor", "description": "Install a Unity Editor version via Unity Hub" },
+    { "name": "unity_hub_available_releases", "description": "List Unity versions available for download" },
+    { "name": "unity_hub_install_modules", "description": "Install platform modules for a Unity version" },
+    { "name": "unity_hub_get_install_path", "description": "Get default Unity install path" },
+    { "name": "unity_hub_set_install_path", "description": "Set default Unity install path" },
+    { "name": "unity_editor_ping", "description": "Ping the Unity Editor to check connection status" },
+    { "name": "unity_editor_state", "description": "Get current Unity Editor state (play mode, scene, project)" },
+    { "name": "unity_project_info", "description": "Get project information (name, version, packages, settings)" },
+    { "name": "unity_scene_info", "description": "Get information about the current scene" },
+    { "name": "unity_scene_hierarchy", "description": "Get the full scene hierarchy tree" },
+    { "name": "unity_scene_open", "description": "Open a scene by asset path" },
+    { "name": "unity_scene_save", "description": "Save the current scene" },
+    { "name": "unity_scene_new", "description": "Create a new empty scene" },
+    { "name": "unity_scene_stats", "description": "Get comprehensive scene statistics" },
+    { "name": "unity_gameobject_create", "description": "Create a new GameObject in the scene" },
+    { "name": "unity_gameobject_delete", "description": "Delete a GameObject from the scene" },
+    { "name": "unity_gameobject_info", "description": "Get detailed info about a GameObject" },
+    { "name": "unity_gameobject_set_transform", "description": "Set position, rotation, scale of a GameObject" },
+    { "name": "unity_gameobject_duplicate", "description": "Duplicate a GameObject with all children" },
+    { "name": "unity_gameobject_set_active", "description": "Set a GameObject active or inactive" },
+    { "name": "unity_gameobject_reparent", "description": "Move a GameObject under a new parent" },
+    { "name": "unity_component_add", "description": "Add a component to a GameObject" },
+    { "name": "unity_component_remove", "description": "Remove a component from a GameObject" },
+    { "name": "unity_component_get_properties", "description": "Get serialized properties of a component" },
+    { "name": "unity_component_set_property", "description": "Set a property value on a component" },
+    { "name": "unity_component_set_reference", "description": "Set an object reference on a component property" },
+    { "name": "unity_component_batch_wire", "description": "Wire multiple object references in one call" },
+    { "name": "unity_component_get_referenceable", "description": "Discover assignable objects for a property" },
+    { "name": "unity_asset_list", "description": "List assets in the project" },
+    { "name": "unity_asset_import", "description": "Import a file as an asset" },
+    { "name": "unity_asset_delete", "description": "Delete an asset from the project" },
+    { "name": "unity_asset_create_prefab", "description": "Create a prefab from a GameObject" },
+    { "name": "unity_asset_instantiate_prefab", "description": "Instantiate a prefab in the scene" },
+    { "name": "unity_script_create", "description": "Create a new C# script" },
+    { "name": "unity_script_read", "description": "Read a C# script's contents" },
+    { "name": "unity_script_update", "description": "Update a C# script's contents" },
+    { "name": "unity_execute_code", "description": "Execute C# code in the Unity Editor (Roslyn)" },
+    { "name": "unity_material_create", "description": "Create a new material" },
+    { "name": "unity_renderer_set_material", "description": "Assign a material to a renderer" },
+    { "name": "unity_build", "description": "Build the project for a target platform" },
+    { "name": "unity_play_mode", "description": "Control play mode (play, pause, stop)" },
+    { "name": "unity_console_log", "description": "Get recent Unity console messages" },
+    { "name": "unity_console_clear", "description": "Clear the Unity console" },
+    { "name": "unity_execute_menu_item", "description": "Execute a Unity Editor menu command" },
+    { "name": "unity_undo", "description": "Undo the last operation" },
+    { "name": "unity_redo", "description": "Redo the last undone operation" },
+    { "name": "unity_undo_history", "description": "Get current undo group info" },
+    { "name": "unity_selection_get", "description": "Get currently selected GameObjects" },
+    { "name": "unity_selection_set", "description": "Set editor selection" },
+    { "name": "unity_selection_focus_scene_view", "description": "Frame a GameObject in Scene View" },
+    { "name": "unity_selection_find_by_type", "description": "Find GameObjects by component type" },
+    { "name": "unity_search_by_component", "description": "Search scene by component type" },
+    { "name": "unity_search_by_tag", "description": "Search scene by tag" },
+    { "name": "unity_search_by_layer", "description": "Search scene by layer" },
+    { "name": "unity_search_by_name", "description": "Search scene by name pattern" },
+    { "name": "unity_search_assets", "description": "Search project assets" },
+    { "name": "unity_search_missing_references", "description": "Find missing references in scene" },
+    { "name": "unity_screenshot_game", "description": "Capture Game View screenshot" },
+    { "name": "unity_screenshot_scene", "description": "Capture Scene View screenshot" },
+    { "name": "unity_screenshot_editor_window", "description": "Capture any Editor window (Inspector, Project, custom) to PNG — Windows only" },
+    { "name": "unity_graphics_scene_capture", "description": "Capture Scene View as inline image" },
+    { "name": "unity_graphics_game_capture", "description": "Capture Game View as inline image" },
+    { "name": "unity_prefab_info", "description": "Get prefab information and overrides" },
+    { "name": "unity_set_object_reference", "description": "Set an object reference via prefab system" },
+    { "name": "unity_packages_list", "description": "List installed Unity packages" },
+    { "name": "unity_packages_add", "description": "Install a Unity package" },
+    { "name": "unity_packages_remove", "description": "Remove a Unity package" },
+    { "name": "unity_packages_search", "description": "Search Unity package registry" },
+    { "name": "unity_packages_info", "description": "Get package details" },
+    { "name": "unity_queue_info", "description": "Get multi-agent queue state" },
+    { "name": "unity_agents_list", "description": "List active agent sessions" },
+    { "name": "unity_agent_log", "description": "Get action log for an agent" },
+    { "name": "unity_list_advanced_tools", "description": "Browse 193 advanced tools by category (animation, physics, lighting, shaders, profiling, etc.)" },
+    { "name": "unity_advanced_tool", "description": "Execute any advanced tool by name + params" },
+    { "name": "unity_get_project_context", "description": "Get project-specific documentation context" }
+  ],
+  "prompts": [
+    {
+      "name": "setup_scene",
+      "description": "Set up a basic Unity scene with common elements",
+      "text": "Help me set up a Unity scene. Start by checking the connection to Unity, then show me the current hierarchy. Ask what kind of scene I want to create (e.g., 3D platformer, FPS, puzzle game) and set up appropriate GameObjects, lighting, and a camera."
+    },
+    {
+      "name": "profile_and_optimize",
+      "description": "Profile the project and suggest optimizations",
+      "text": "Profile my Unity project and help me optimize it. Start the profiler, take a memory snapshot, check the console for warnings, and analyze the results. Give me specific, actionable recommendations for improving performance."
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@mseep/anklebreaker-unity-mcp",
+  "version": "2.30.0",
+  "description": "Unity MCP Server \u2014 Multi-agent MCP server for Unity Editor, designed for Claude Cowork. By AnkleBreaker Studio.",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "unity-mcp": "./src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node --watch src/index.js",
+    "pack": "npx @anthropic-ai/mcpb pack . unity-mcp.mcpb && npx @anthropic-ai/mcpb clean unity-mcp.mcpb"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mseep",
+    "mcp-server"
+  ],
+  "publisher": "mseep"
+}

package/src/config.js

@@ -0,0 +1,52 @@
+// AnkleBreaker Unity MCP — Configuration
+// Adjust these paths to match your Unity installation
+
+import { homedir } from "os";
+import { join } from "path";
+
+// Determine the instance registry path based on platform
+function getRegistryPath() {
+  if (process.platform === "win32") {
+    const localAppData = process.env.LOCALAPPDATA || join(homedir(), "AppData", "Local");
+    return join(localAppData, "UnityMCP", "instances.json");
+  }
+  // macOS / Linux
+  return join(homedir(), ".local", "share", "UnityMCP", "instances.json");
+}
+
+export const CONFIG = {
+  // Unity Hub
+  unityHubPath: process.env.UNITY_HUB_PATH || "C:\\Program Files\\Unity Hub\\Unity Hub.exe",
+
+  // Unity Editor Bridge (default — used as fallback when no instance is selected)
+  editorBridgeHost: process.env.UNITY_BRIDGE_HOST || "127.0.0.1",
+  editorBridgePort: parseInt(process.env.UNITY_BRIDGE_PORT || "7890"),
+  editorBridgeTimeout: parseInt(process.env.UNITY_BRIDGE_TIMEOUT || "60000"),
+
+  // Multi-instance support
+  portRangeStart: parseInt(process.env.UNITY_PORT_RANGE_START || "7890"),
+  portRangeEnd: parseInt(process.env.UNITY_PORT_RANGE_END || "7899"),
+  instanceRegistryPath: process.env.UNITY_INSTANCE_REGISTRY || getRegistryPath(),
+
+  // Queue mode polling (for async ticket-based requests)
+  queuePollIntervalMs: parseInt(process.env.UNITY_QUEUE_POLL_INTERVAL || "150"),
+  queuePollMaxMs: parseInt(process.env.UNITY_QUEUE_POLL_MAX || "1500"),
+  queuePollTimeoutMs: parseInt(process.env.UNITY_QUEUE_POLL_TIMEOUT || "120000"), // Max total poll time (2 min)
+
+  // Default Unity Editor path pattern (version will be interpolated)
+  editorPathPattern: process.env.UNITY_EDITOR_PATH || "C:\\Program Files\\Unity\\Hub\\Editor\\{version}\\Editor\\Unity.exe",
+
+  // Registry staleness timeout (ms) — if a registry entry's lastSeen timestamp is older
+  // than this AND the port is unresponsive, the entry is considered stale (Unity likely crashed).
+  // The plugin sends a heartbeat every 30s, so 5 minutes gives plenty of margin.
+  registryStalenessTimeoutMs: parseInt(process.env.UNITY_REGISTRY_STALENESS_TIMEOUT || "300000"), // 5 minutes
+
+  // Response size limits (bytes) — protects against Write EOF errors on large projects
+  // Soft limit: log a warning but still return the response
+  responseSoftLimitBytes: parseInt(process.env.UNITY_RESPONSE_SOFT_LIMIT || String(2 * 1024 * 1024)),   // 2 MB
+  // Hard limit: truncate the response and return pagination guidance instead
+  responseHardLimitBytes: parseInt(process.env.UNITY_RESPONSE_HARD_LIMIT || String(4 * 1024 * 1024)),   // 4 MB
+
+  // Logging
+  logLevel: process.env.LOG_LEVEL || "info",
+};