UnityMCP는 모델 컨텍스트 프로토콜(MCP)을 구현한 강력한 Unity Editor 플러그인으로, Unity와 AI 어시스턴트 간의 원활한 통합을 가능하게 합니다. 실시간 편집기 상태 모니터링, 원격 명령 실행, 포괄적인 로깅 기능을 제공합니다.

건축

이 프로젝트는 두 가지 주요 구성 요소로 구성되어 있습니다:

1. Unity 플러그인 (UnityMCPPlugin)

Unity Editor 플러그인으로, 다음을 제공합니다:

• 연결 상태 및 모니터링을 위한 디버그 창
• 실시간 통신을 위한 WebSocket 클라이언트
• C# 코드 실행 엔진
• 종합 로그 시스템
• 편집기 상태 추적 및 직렬화

2. MCP 서버 (unity-mcp-server)

표준화된 도구를 통해 Unity Editor 기능을 노출하는 TypeScript 기반 MCP 서버:

사용 가능한 도구

1. get_editor_state

• 현재 Unity Editor 상태 조회
• 활성 GameObjects, 선택 상태, 플레이 모드 상태 포함
• 씬 계층 구조 및 프로젝트 구조 제공
• 다양한 출력 형식(Raw, 스크립트 전용, 스크립트 없음) 지원

2. execute_editor_command

• Unity 편집기에서 직접 C# 코드를 실행함
• UnityEngine 및 UnityEditor API에 대한 완전한 접근 권한

UnityMCP

UnityMCP is a powerful Unity Editor plugin that implements the Model Context Protocol (MCP), enabling seamless integration between Unity and AI assistants. It provides real-time editor state monitoring, remote command execution, and comprehensive logging capabilities.

Architecture

The project consists of two main components:

1. Unity Plugin (UnityMCPPlugin)

A Unity Editor plugin that provides:

• Debug window for connection status and monitoring
• WebSocket client for real-time communication
• C# code execution engine
• Comprehensive logging system
• Editor state tracking and serialization

2. MCP Server (unity-mcp-server)

A TypeScript-based MCP server that exposes Unity Editor functionality through standardized tools:

Available Tools

1. get_editor_state

   • Retrieves current Unity Editor state
   • Includes active GameObjects, selection state, play mode status
   • Provides scene hierarchy and project structure
   • Supports different output formats (Raw, scripts only, no scripts)

2. execute_editor_command

   • Executes C# code directly in the Unity Editor
   • Full access to UnityEngine and UnityEditor APIs
   • Real-time execution with comprehensive error handling
   • Command timeout protection

3. get_logs

   • Retrieves and filters Unity Editor logs
   • Supports filtering by type, content, and timestamp
   • Customizable output fields
   • Buffer management for optimal performance

Installation

Installing via Smithery

To install UnityMCP for Claude Desktop automatically via Smithery: