IvanMurzak/Unity-MCP

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.

해결하는 문제

Unity MCP는 AI 에이전트(Claude, Cursor, Windsurf 등)를 Unity 게임 엔진에 직접 연결하는 방법을 제공합니다. 이는 LLM과 에디터 사이에서 코드와 지침을 수동으로 복사하는 프로세스를 제거하여, AI가 워크플로우를 자동화하고 게임 메커니즘을 생성하며 에디터 및 컴파일된 게임 내에서 실시간 디버깅을 수행할 수 있도록 합니다.

작동 방식

이 프로젝트는 Model Context Protocol (MCP)을 구현하여 AI 에이전트와 Unity 사이의 가교 역할을 합니다. AI가 Unity의 AssetDatabase, Hierarchy, Scene, Profiler와 상호 작용하기 위해 호출할 수 있는 일련의 "도구"(70개 이상의 내장 도구)를 제공합니다. stdio를 통해 로컬에 배포하거나 HTTP를 통해 원격으로 배포할 수 있습니다. 시스템은 프로젝트의 특정 OS, Unity 버전 및 설치된 플러그인을 기반으로 "기술"을 자동으로 생성할 수 있습니다.

대상 사용자

개발 파이프라인에 LLM 기반 자동화를 통합하거나 실행 중인 게임에 AI 기반 동작 및 디버깅 도구를 직접 구현하고자 하는 Unity 게임 개발자.

주요 특징

  • 에디터 및 런타임 지원: Unity 에디터 내부 및 컴파일된 게임 빌드 내에서 작동하여 실시간 상호 작용을 지원합니다.
  • 광범위한 도구 세트: 에셋 관리, 씬 조작, 스크립팅 및 프로파일링을 위한 70개 이상의 내장 도구가 포함되어 있습니다.
  • 에이전트 불가지론(Agent Agnostic): Claude, Cursor, GitHub Copilot, Gemini를 포함한 다양한 AI 에이전트와 호환됩니다.
  • 동적 코드 실행: Roslyn을 사용하여 C# 코드를 동적으로 컴파일하고 실행할 수 있습니다.
  • 커스터마이징 가능: 프로젝트 코드 내에서 사용자 정의 도구 및 MCP 프롬프트 생성을 지원합니다.