[!수신] 이 저장소는 deprecated. 개발은 akiojin/unity-cli로 이동했습니다. 이 저장소는 더 이상 업데이트를받지 않습니다. Successor 프로젝트에 참여하십시오.

한국어 |

개요

Unity MCP Server는 LLM 기반 클라이언트가 Unity Editor를 자동화합니다. 간단한 인터페이스와 Zero 또는 low-configuration 설정으로 신뢰할 수 있는 작업 흐름에 중점을 둡니다.

무엇을 할 수 있습니까?

• **Editor 자동화 **: Create/modify 장면, GameObjects, 구성 요소, 조립식, 재료
• **UI 자동화 **: UI, validate UI state와 상호 작용
• 입력 시뮬레이션: Playmode 테스트를 위한 Keyboard/mouse/gamepad/touch (입력 시스템 전용) -Visual 캡처: Game/Scene/Explorer/Window의 Deterministic 스크린 샷 -Code 기본 인식: 묶인 C# LSP ([T0]]] 파일에 의해 구동되는 안전한 구조화 편집 및 정확한 상징/연구)
• ** 제어 **: Read/update project/editor 설정; 로그, 모니터 컴파일
• 주소 관리: 자산 관리, 그룹 관리, 자동화 구축

성과

Code 인덱스 도구 outperform 표준 파일 작업:

| 운영 | 코드 인덱스 도구 | 표준 공구 | 장점 |

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:

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

1. Install the Unity package (Git URL or OpenUPM)
2. Configure your MCP client with the JSON above