Plugin

unity-mcp-server

Name: unity-mcp-server
Author: akiojin

Automate Unity Editor workflows: edit and refactor C# scripts, manage scenes/GameObjects/assets/prefabs, design UIs with uGUI/UI Toolkit/IMGUI, run PlayMode tests via input simulation/screenshots/logs, capture status reports and screenshots using 108+ MCP tools and subagent.

npx claudepluginhub akiojin/unity-mcp-server --plugin unity-mcp-server

Component Overview

Commands

Agents

Skills

Component Details

Commands (2)

Unity Screenshot Capture

/unity-screenshot

Capture screenshots from Unity Editor Game/Scene/Explorer views

Unity Status Check

/unity-status

Check Unity Editor connection, scene info, and compilation state

Agents (1)

unity-helper

/unity-helper

Unity development assistant using Unity MCP Server. Provides integrated support for C# editing, scene operations, playmode testing, and asset management. Efficiently utilizes 108+ Unity automation tools.

Skills (8)

unity-asset-management

/unity-asset-management

Supports creating, editing, and managing Unity assets (prefabs, materials, asset database, Addressables). Includes dependency analysis and import settings. Use when: prefab creation, material editing, asset search, dependency analysis, Addressables

unity-csharp-editing

/unity-csharp-editing

Supports Unity C# script editing, searching, and refactoring. Enables TDD cycle code editing, symbol navigation, reference searching, and structured editing. Use when: C# editing, script search, symbol search, refactoring, code indexing, class creation, method addition

unity-development

/unity-development

Comprehensive guide for Unity development. Provides architecture patterns, MCP tool selection, and composite task workflows. Parent skill always referenced for Unity-related tasks. See child skills for detailed implementation. Use when: Unity development in general, C# editing, scene operations, UI implementation, asset management, PlayMode testing

unity-editor-imgui-design

/unity-editor-imgui-design

Unity IMGUI (Immediate Mode GUI) for editor tools and custom inspectors. Use for EditorWindow, Custom Inspector, Property Drawer development. NOT for game UI - use unity-game-ugui-design or unity-game-ui-toolkit-design instead.

unity-game-ugui-design

/unity-game-ugui-design

Game UI design using Unity's uGUI (Canvas/RectTransform/Anchors). Includes game UI elements like HUD, health bars, inventory, skill bars, mobile responsive design, and Safe Area support. Use when: game UI design, HUD creation, Canvas setup, mobile UI, Anchors configuration

unity-game-ui-toolkit-design

/unity-game-ui-toolkit-design

Game UI design using Unity's UI Toolkit (USS/UXML/Flexbox). Includes game UI elements like HUD, health bars, inventory, skill bars, PanelSettings scaling, and Safe Area support. Use when: game UI design, HUD creation, USS/UXML styling, Flexbox layout, PanelSettings configuration

unity-playmode-testing

/unity-playmode-testing

Supports Unity Play Mode control, input simulation, UI automation, and visual verification. Integrates test execution, screenshot/video capture, and console log checking. Use when: starting Play Mode, input simulation, UI clicks, screenshots, video recording, test execution

unity-scene-management

/unity-scene-management

Supports Unity scene and GameObject creation, management, and analysis. Efficiently performs hierarchy operations, component configuration, and scene analysis. Use when: scene creation, scene loading, GameObject creation, component addition, hierarchy retrieval, scene analysis

README

Unity MCP Server

[!WARNING] This repository is deprecated. Development has moved to akiojin/unity-cli. This repository will no longer receive updates. Please migrate to the successor project.

English | 日本語

Overview

Unity MCP Server lets LLM-based clients automate the Unity Editor. It focuses on reliable, scriptable workflows with a simple interface and zero or low-configuration setup.

What It Can Do

Editor automation: Create/modify scenes, GameObjects, components, prefabs, materials
UI automation: Locate and interact with UI, validate UI state
Input simulation: Keyboard/mouse/gamepad/touch for playmode testing (Input System only)
Visual capture: Deterministic screenshots from Game/Scene/Explorer/Window views
Code base awareness: Safe structured edits and accurate symbol/search powered by bundled C# LSP (no .sln file required)
Project control: Read/update project/editor settings; read logs, monitor compilation
Addressables management: Register/organize assets, manage groups, build automation

Performance

Code index tools outperform standard file operations:

Operation	Code Index Tool	Standard Tool	Advantage
Symbol lookup	`find_symbol`	`grep`	Instant vs 350ms
Reference search	`find_refs`	`grep`	Structured results
Code search	`search`	`grep`	3-5x smaller responses

Key benefits:

128,040 files indexed with 100% coverage
Non-blocking background index builds (Worker Threads)
LLM-optimized output with pagination and size limits

For detailed benchmarks, see docs/benchmark-results-2025-12-13.md

Requirements

Unity 2020.3 LTS or newer
Node.js 18.x / 20.x / 22.x / 24.x LTS (25+ not supported)
Claude Desktop or another MCP-compatible client

Installation

Unity Package

Package Manager → Add from git URL:

https://github.com/akiojin/unity-mcp-server.git?path=UnityMCPServer/Packages/unity-mcp-server

Or via OpenUPM:

openupm add com.akiojin.unity-mcp-server

MCP Client Configuration

Configure your MCP client (Claude Desktop example):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "npx",
      "args": ["@akiojin/unity-mcp-server@latest"]
    }
  }
}

HTTP Mode (for HTTP-only networks)

npx @akiojin/unity-mcp-server --http 6401 --no-telemetry
curl http://localhost:6401/healthz

Quick Start

Install the Unity package (Git URL or OpenUPM)
Configure your MCP client with the JSON above
Open your Unity project (package starts TCP listener on port 6400)
Launch your MCP client (it connects to the Node server)
Test the connection with ping

Tip: npx @akiojin/unity-mcp-server@latest downloads and runs the latest build without cloning.

Architecture

┌────────────────┐        JSON-RPC (MCP)        ┌──────────────────────┐
│  MCP Client    │ ───────────────────────────▶ │  Node MCP Server     │
│ (Claude/Codex/ │ ◀─────────────────────────── │ (@akiojin/unity-     │
│   Cursor …)    │        tool responses        │ mcp-server)          │
└────────────────┘                              └──────────┬───────────┘
                                                         TCP│6400
                                                            ▼
                                                   ┌───────────────────┐
                                                   │  Unity Editor     │
                                                   │  (Package opens   │
                                                   │   TCP listener)   │
                                                   └───────────────────┘

Configuration

Configuration is optional; defaults work without any config file.

Node-side configuration uses environment variables only, and Unity-side host/port lives in Project Settings.

See docs/configuration.md.

Tools

Unity MCP Server ships 100+ tools. Use the search_tools meta-tool to discover the right tool quickly.

For clients with strict tool-count limits, you can filter exposed tools by category:

export UNITY_MCP_TOOL_INCLUDE_CATEGORIES=system,scene,gameobject,analysis,script
export UNITY_MCP_TOOL_EXCLUDE_CATEGORIES=ui,input,addressables,video,screenshot,profiler

See docs/tools.md for discovery tips and the recommended Code Index workflow.

Note: find_refs supports paging via startAfter and returns cursor when results are truncated.

Claude Code Skills

View full README on GitHub

Similar Plugins

unity-cli

Claude Code plugin for workflow-oriented Rust-based unity-cli automation.

Stats

Version1.0.1

Parent Repo Stars23

Parent Repo Forks6

MaintenanceFair

AddedJan 28, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Available In

unity-mcp-server23

Help us improve

Share bugs, ideas, or general feedback.

Back to Plugins

Unity MCP Server

[!WARNING] This repository is deprecated. Development has moved to akiojin/unity-cli. This repository will no longer receive updates. Please migrate to the successor project.

English | 日本語

Overview

Unity MCP Server lets LLM-based clients automate the Unity Editor. It focuses on reliable, scriptable workflows with a simple interface and zero or low-configuration setup.

What It Can Do

Editor automation: Create/modify scenes, GameObjects, components, prefabs, materials
UI automation: Locate and interact with UI, validate UI state
Input simulation: Keyboard/mouse/gamepad/touch for playmode testing (Input System only)
Visual capture: Deterministic screenshots from Game/Scene/Explorer/Window views
Code base awareness: Safe structured edits and accurate symbol/search powered by bundled C# LSP (no .sln file required)
Project control: Read/update project/editor settings; read logs, monitor compilation
Addressables management: Register/organize assets, manage groups, build automation

Performance

Code index tools outperform standard file operations:

Operation	Code Index Tool	Standard Tool	Advantage
Symbol lookup	`find_symbol`	`grep`	Instant vs 350ms
Reference search	`find_refs`	`grep`	Structured results
Code search	`search`	`grep`	3-5x smaller responses

Key benefits:

128,040 files indexed with 100% coverage
Non-blocking background index builds (Worker Threads)
LLM-optimized output with pagination and size limits

For detailed benchmarks, see docs/benchmark-results-2025-12-13.md

Requirements

Unity 2020.3 LTS or newer
Node.js 18.x / 20.x / 22.x / 24.x LTS (25+ not supported)
Claude Desktop or another MCP-compatible client

Installation

Unity Package

Package Manager → Add from git URL:

https://github.com/akiojin/unity-mcp-server.git?path=UnityMCPServer/Packages/unity-mcp-server

Or via OpenUPM:

openupm add com.akiojin.unity-mcp-server

MCP Client Configuration

Configure your MCP client (Claude Desktop example):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "npx",
      "args": ["@akiojin/unity-mcp-server@latest"]
    }
  }
}

HTTP Mode (for HTTP-only networks)

npx @akiojin/unity-mcp-server --http 6401 --no-telemetry
curl http://localhost:6401/healthz

Quick Start

Install the Unity package (Git URL or OpenUPM)
Configure your MCP client with the JSON above
Open your Unity project (package starts TCP listener on port 6400)
Launch your MCP client (it connects to the Node server)
Test the connection with ping

Tip: npx @akiojin/unity-mcp-server@latest downloads and runs the latest build without cloning.

Architecture

┌────────────────┐        JSON-RPC (MCP)        ┌──────────────────────┐
│  MCP Client    │ ───────────────────────────▶ │  Node MCP Server     │
│ (Claude/Codex/ │ ◀─────────────────────────── │ (@akiojin/unity-     │
│   Cursor …)    │        tool responses        │ mcp-server)          │
└────────────────┘                              └──────────┬───────────┘
                                                         TCP│6400
                                                            ▼
                                                   ┌───────────────────┐
                                                   │  Unity Editor     │
                                                   │  (Package opens   │
                                                   │   TCP listener)   │
                                                   └───────────────────┘

Configuration

Configuration is optional; defaults work without any config file.

Node-side configuration uses environment variables only, and Unity-side host/port lives in Project Settings.

See docs/configuration.md.

Tools

Unity MCP Server ships 100+ tools. Use the search_tools meta-tool to discover the right tool quickly.

For clients with strict tool-count limits, you can filter exposed tools by category:

export UNITY_MCP_TOOL_INCLUDE_CATEGORIES=system,scene,gameobject,analysis,script
export UNITY_MCP_TOOL_EXCLUDE_CATEGORIES=ui,input,addressables,video,screenshot,profiler

See docs/tools.md for discovery tips and the recommended Code Index workflow.

Note: find_refs supports paging via startAfter and returns cursor when results are truncated.

unity-mcp-server

Component Overview

Component Details

Commands (2)

Agents (1)

Skills (8)

README

Unity MCP Server

Overview

What It Can Do

Performance

Requirements

Installation

Unity Package

MCP Client Configuration

HTTP Mode (for HTTP-only networks)

Quick Start

Architecture

Configuration

Tools

Claude Code Skills

Similar Plugins

unity-cli

Help us improve

Help us improve

unity-mcp-server

Component Overview

Component Details

Commands (2)

Agents (1)

Skills (8)

README

Unity MCP Server

Overview

What It Can Do

Performance

Requirements

Installation

Unity Package

MCP Client Configuration

HTTP Mode (for HTTP-only networks)

Quick Start

Architecture

Configuration

Tools

Claude Code Skills

Similar Plugins

unity-cli

Help us improve

ucp

unicli

taconotsandwich-unity-agentic-tools

unity-dev-toolkit

unity-master