UnityMCP

Overview

UnityMCP is a comprehensive framework for connecting Unity Editor with AI assistants through the Model Context Protocol. It features a dual architecture with both TypeScript MCP server and C# Unity plugin, supporting HTTP access for direct API calls and MCP tool integration for AI assistants like Claude. The system includes UDP discovery for multiple Unity instances, idempotent command handling, and extensible plugin architecture allowing custom command implementations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• unity_listClients

  List available Unity clients connected to MCP

  Try:List all available Unity clientsTry:Show me connected Unity editors
• unity_setActiveClient

  Set the active Unity client for subsequent operations

  Try:Set MyProject as the active clientTry:Switch to client with ID abc123
• unity_connectToProject

  Connect to a specific Unity project

  Try:Connect to the MyProject Unity sessionTry:Establish connection to Unity client
• unity_getActiveClient

  Get information about the currently active Unity client

  Try:Which client is currently active?Try:Show details of the active Unity editor
• unity_execute_code

  Execute C# code in the Unity editor using Roslyn

  Try:Execute C# code to find all GameObjectsTry:Run script: GameObject.FindObjectsByType<Transform>(FindObjectsSortMode.None).Length
• console_getLogs

  Get console logs from Unity editor

  Try:Show me the Unity console logsTry:Get recent console output
• console_getCount

  Get count of console log messages

  Try:How many console messages are there?Try:Count error messages in console
• console_clear

  Clear the Unity console

  Try:Clear the Unity consoleTry:Reset console logs
• console_setFilter

  Set filter for console log messages

  Try:Filter console to show only errorsTry:Set log filter to warnings only
• menu_execute

  Execute Unity menu commands

  Try:Execute Build menu commandTry:Run File > Save Assets
• browse_hierarchy

  Browse Unity scene hierarchy with filters

  Try:Show scene hierarchyTry:List all GameObjects with 'Player' in name
• inspect

  Inspect GameObject and Component properties

  Try:Inspect Main Camera propertiesTry:Check position of player GameObject

Comparable tools

Installation

{
  "mcpServers": {
    "unity-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/unity-mcp-ts/build/index.js"]
    }
  }
}

FAQ

How do I connect to multiple Unity Editors?

Use the proxy endpoint on port 27180 or specify a target parameter with project name. The system automatically discovers multiple Unity instances via UDP broadcast.

Is the code execution feature secure?

The `/execute_code` endpoint can run arbitrary C# code. In shared environments, disable it in MCP settings or restrict listeners to loopback only (default behavior).

Compare UnityMCP with