Unity AI MCP Server

What is Unity AI MCP Server?

Unity AI MCP Server is a Model Context Protocol (MCP) server that integrates Unity AI capabilities with Smithery.ai. It provides tools for analyzing Unity projects, generating scripts, finding asset references, and safely executing code in a sandboxed Unity Editor instance.

How to use Unity AI MCP Server?

Clone the repository, run npm install, copy .env.example to .env, edit required fields like UNITY_PROJECT_PATH, then build with npm run build and start with npm start. For Smithery.ai integration, set SMITHERY_ENABLED=1 and provide SMITHERY_API_KEY in the .env file. The server offers REST API, stdin/stdout interface, and Smithery.ai tool access.

Key features of Unity AI MCP Server

• MCP server for Unity AI integration
• RESTful API and stdin/stdout interfaces
• Unity project analysis and navigation
• Script generation and manipulation
• Sandbox mode for safe code execution
• Smithery.ai advanced AI capability integration
• Asset reference finding across projects

Use cases of Unity AI MCP Server

• Explore and navigate Unity project structure with Project Explorer
• Get guidance on Unity script development via Script Advisor
• Find references to assets in a Unity project
• Safely execute and test Unity code in a sandboxed Editor instance
• Leverage Smithery.ai AI tools alongside Unity analysis

FAQ from Unity AI MCP Server

What dependencies are required?

Node.js and npm are required. For sandbox mode, the Unity Editor executable path must be set in the .env file.

What configuration is mandatory?

The UNITY_PROJECT_PATH environment variable is required to point to your Unity project. Without it the server cannot start.

What transports and interfaces does the server support?

It supports stdin/stdout communication, a REST API (enable via ENABLE_REST_API), and Smithery.ai integration (enable via SMITHERY_ENABLED).

Does the server execute code or modify the Unity project?

Yes. Tools like Project Explorer, Script Advisor, and Asset Reference Finder read the project. Sandbox Runner safely executes code in a Unity Editor instance (requires UNITY_EDITOR_PATH). Always review modifications before applying.

How does sandbox mode enhance security?

When ENABLE_SANDBOX=1, code execution is isolated to a separate Unity Editor process, preventing unintended changes to your main project. It requires the Unity Editor executable path.