An advanced MCP server for Unity3D Game Engine that enables AI assistants to interact with Unity Editor in real time, supporting code execution, project file manipulation, scene hierarchy access, and comprehensive project state monitoring.

Installation

Unity Package Manager (Git URL)

1. Open Unity Package Manager (Window > Package Manager)
2. Click + button and select 'Add package from git URL...'
3. Enter: https://github.com/quazaai/UnityMCPIntegration.git
4. Click Add

Unity Custom Package

1. Clone repository or download as unityPackage
2. In Unity: Assets > Import Package > Custom Package
3. Select UnityMCPIntegration.unitypackage

MCP Server Direct Run

cd mcpServer
npm install
node build/index.js

Smithery Installation

npx -y @smithery/cli install @quazaai/unitymcpintegration --client claude

Configuration

MCP Host Configuration

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "node",
      "args": [
        "path-to-project>\\Library\\PackageCache\\com.quaza.unitymcp@d2b8f1260bca\\mcpServer\\mcpServer\\build\\index.js"
      ],
      "env": {
        "MCP_WEBSOCKET_PORT": "5010"
      }
    }
  }
}

Available Tools

Tool	Description
get_editor_state	Get comprehensive information about Unity project and editor state
get_current_scene_info	Get detailed information about the current scene
get_game_objects_info	Get information about specific GameObjects in the scene
execute_editor_command	Execute C# code directly in Unity Editor
get_logs	Get and filter Unity console logs
verify_connection	Verify active connection to Unity Editor
read_file	Read file contents from your Unity project
read_multiple_files	Read multiple files at once
write_file	Create or overwrite a file with new content
edit_file	Make targeted changes to existing files with diff preview
list_directory	Get a list of files and folders in a directory
directory_tree	Get a hierarchical view of directories and files
search_files	Find files matching a search pattern
get_file_info	Get metadata about a specific file or directory
find_assets_by_type	Find all assets of a specific type (e.g., Material, Prefab)

Features

• View and manipulate project files directly
• Access your Unity project information in real time
• Understand scene hierarchy and game objects
• Execute C# code directly in Unity Editor
• Monitor logs and errors
• Manage Editor play mode
• Await code execution
• WebSocket communication between Unity and MCP server
• File system access is restricted to the Unity project directory for security
• Support for both absolute and relative file paths

Environment Variables

Optional

• MCP_WEBSOCKET_PORT - WebSocket port for Unity MCP server communication

Usage Examples

Get a directory listing: list_directory(path: "Scenes")

Read a script file: read_file(path: "Scripts/Player.cs")

Edit a configuration file: edit_file(path: "Resources/config.json", edits: [{oldText: "value: 10", newText: "value: 20"}], dryRun: true)

Find all materials: find_assets_by_type(assetType: "Material")

Notes

Requires Unity 2021.3+ and Node.js 18+. Communication between the Unity plugin and MCP server occurs via WebSocket. The system includes a comprehensive MCP Debug window accessible via Window > MCP Debug for monitoring connections and testing capabilities. File operations are handled intelligently with paths resolved relative to the project's Assets folder.