ai-driven unity editor menu item execution via mcp protocol
Enables AI assistants to execute Unity Editor menu items (File, Edit, Assets, etc.) by translating natural language requests into JSON-RPC calls through a Node.js MCP server that relays commands via WebSocket to the Unity McpUnitySocketHandler, which dispatches them to the EditorApplication.ExecuteMenuItem API. This allows AI agents to trigger built-in editor workflows without direct UI interaction.
Unique: Uses MCP protocol as the transport layer for menu execution rather than direct REST/gRPC APIs, enabling seamless integration with AI assistants that natively support MCP (Claude, Windsurf) without custom client code. The WebSocket bridge pattern allows stateful editor context to persist across multiple AI requests.
vs alternatives: Simpler than building custom REST endpoints for each menu operation and more reliable than UI automation tools because it uses native EditorApplication APIs directly.
hierarchical scene graph querying and gameobject selection
Provides AI assistants with read-only access to the complete scene hierarchy via MCP resources that serialize the Transform tree structure, enabling agents to query GameObject names, parent-child relationships, and active states. The McpUnitySocketHandler exposes scene data as JSON-RPC resources that can be filtered by name, tag, or layer, allowing AI to understand spatial relationships and select specific GameObjects for subsequent operations.
Unique: Exposes the entire scene hierarchy as a queryable MCP resource rather than requiring separate API calls per GameObject, enabling AI assistants to reason about spatial relationships and make informed decisions about which objects to target. Uses JSON serialization of Transform chains to preserve parent-child context.
vs alternatives: More efficient than querying individual GameObjects via separate API calls and provides richer context for AI reasoning compared to flat GameObject lists.
docker-based deployment and containerized mcp server hosting
Provides Docker configuration and deployment scripts that containerize the Node.js MCP server, enabling AI-Unity integration to run in isolated environments without local Node.js installation. The Dockerfile packages the MCP server with dependencies and exposes the WebSocket port, allowing deployment to cloud environments or CI/CD pipelines with consistent runtime behavior.
Unique: Provides production-ready Docker configuration for the MCP server rather than requiring manual deployment setup, enabling teams to deploy AI-Unity integration to cloud environments without custom DevOps work. Includes environment variable configuration for flexible deployment scenarios.
vs alternatives: More portable than local Node.js installation and enables cloud deployment compared to desktop-only setups.
extensible tool and resource handler architecture for custom capabilities
Implements a plugin-style architecture where new MCP tools and resources can be added by extending base handler classes and registering them with the tool/resource registry. The McpTools and McpResources base classes provide standard interfaces for tool execution and resource querying, allowing developers to add custom Unity operations without modifying core MCP server code.
Unique: Provides a clean handler interface that allows developers to add custom tools without modifying core MCP server code, following a plugin pattern. Uses TypeScript interfaces to enforce consistent handler signatures across custom implementations.
vs alternatives: More maintainable than monolithic tool implementations and enables community contributions compared to closed architectures.
component inspection and property serialization
Allows AI assistants to inspect all components attached to a selected GameObject and read their serialized properties (Transform position, Rigidbody mass, Collider bounds, etc.) through MCP resources that reflect the component hierarchy. The McpUnitySocketHandler serializes component data to JSON, exposing public fields, properties, and metadata that enable AI to understand the GameObject's behavior and make informed modification decisions.
Unique: Uses Unity's serialization system to expose component properties as queryable JSON rather than requiring AI to parse binary asset files or use reflection directly, making component state transparent to AI agents without deep Unity knowledge. Integrates with the MCP resource registry to provide consistent access patterns.
vs alternatives: More reliable than parsing .meta files or asset bundles and provides real-time component state compared to static asset analysis.
ai-driven gameobject and component creation with property initialization
Enables AI assistants to create new GameObjects and attach components with specified properties by translating natural language requests into JSON-RPC tool calls that invoke Unity's Instantiate and AddComponent APIs. The McpUnitySocketHandler processes tool requests to create GameObjects with initial Transform values, add components like Rigidbody or Collider, and set their properties in a single atomic operation, allowing AI to build scene content programmatically.
Unique: Combines GameObject instantiation and component addition into a single MCP tool call with property initialization, reducing round-trip latency compared to separate create/configure operations. Uses JSON schema validation to ensure property types match component expectations before execution.
vs alternatives: Faster than sequential API calls and more reliable than script-based creation because it uses native Unity APIs with immediate validation feedback.
real-time console log streaming and filtering
Provides AI assistants with access to Unity Editor console output through MCP resources that stream or snapshot debug logs, warnings, and errors with timestamps and stack traces. The getConsoleLogResource handler captures logs from Unity's Debug.Log system and exposes them as queryable JSON, allowing AI to monitor build errors, runtime warnings, and script execution feedback without parsing console UI.
Unique: Exposes Unity's internal Debug.Log stream as a queryable MCP resource rather than requiring AI to parse console UI text, enabling structured error analysis and automated error detection. Integrates with the resource registry to provide consistent polling/subscription patterns.
vs alternatives: More reliable than screen scraping console UI and provides structured data that AI can parse programmatically compared to unstructured log text.
asset database querying and prefab/script discovery
Enables AI assistants to search the Unity asset database for prefabs, scripts, scenes, and other assets by name or type through MCP resources that query the AssetDatabase API. The McpUnitySocketHandler exposes asset metadata (path, type, GUID) as JSON, allowing AI to discover available resources before referencing them in creation or modification operations.
Unique: Wraps Unity's AssetDatabase API as MCP tools/resources, providing AI with structured asset discovery without requiring direct API knowledge. Uses GUID-based asset references to ensure stability across asset moves.
vs alternatives: More reliable than file system scanning because it uses Unity's internal asset database and respects import settings and asset metadata.
+4 more capabilities