Unity MCP Integration

Name: Unity MCP Integration
Author: quazaai

@quazaai

Repository

About Unity MCP Integration

Access real-time information about your Unity project

#unity #mcp #integration #game-development

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "node",
      "args": [
        "<path-to-project>/mcpServer/build/index.js"
      ]
    }
  }
}

Tools

Get comprehensive information about the Unity project and editor state

Get detailed information about the current scene

Get information about specific GameObjects in the scene

Execute C# code directly in the Unity Editor

Retrieve and filter Unity console logs

Overview

What is Unity MCP Integration?

Unity MCP Integration is a package that connects the Model Context Protocol (MCP) to the Unity Editor, enabling AI assistants to access real-time information about project scenes, execute C# code directly in the Editor, monitor logs, and control play mode. It is built for Unity developers who want to leverage AI within their Unity workflow.

How to use Unity MCP Integration?

Install the Unity package via the Package Manager using the Git URL or import the custom package. Then, navigate to the mcpServer directory, run npm install and node build/index.js to start the MCP server, or add the server configuration to your MCP Host. Use the MCP Debug window (Window > MCP Debug) to monitor the connection and test features.

Key features of Unity MCP Integration

Real‑time access to Unity Editor and project state
Retrieve detailed information about the current scene and GameObjects
Execute C# code directly in the Unity Editor via a tool call
Fetch and filter Unity console logs
Control the Editor’s play mode through AI assistants

Use cases of Unity MCP Integration

AI‑assisted scene editing and game object manipulation
Automated debugging and log analysis with AI
Code generation and execution directly in the Unity Editor
Real‑time monitoring of project state during development

FAQ from Unity MCP Integration

What are the prerequisites for using Unity MCP Integration?

You need Unity 2021.3 or later and Node.js 18+ to run the MCP server. The server is written in TypeScript 5.0.

How does Unity MCP Integration communicate?

The Unity plugin (C#) and the MCP server (TypeScript/Node.js) communicate via WebSocket, exchanging JSON messages for commands and data.

What tools does Unity MCP Integration provide to AI assistants?

Available tools include get_editor_state, get_current_scene_info, get_game_objects_info, execute_editor_command, and get_logs.

Can I contribute to this project?

Yes. Fork the repository, create a feature branch, make changes, and open a pull request. Development setup instructions for both Unity and server sides are provided in the README.

How do I set up the MCP server for Claude Desktop?

Add the server to your MCP Host configuration with the command node and arguments pointing to the built index.js file, as shown in the README’s configuration example.