Unity MCP(서버 + 플러그인)

Unity-MCP 는 LLM과 Unity를 연결하는 다리 역할을 합니다. LLM에 Unity 도구를 노출하고 설명합니다. LLM은 Unity 인터페이스를 이해하고 사용자가 원하는 방식으로 도구를 활용합니다.

통합 AI Connector 창을 사용하여 Unity-MCP를 Claude 나 Cursor 와 같은 LLM 클라이언트에 연결하세요. 사용자 지정 클라이언트도 지원됩니다.

이 프로젝트는 개발자가 곧 사용자 지정 도구를 추가할 수 있도록 설계되었습니다. 그 후, 플레이어 빌드에서도 동일한 기능을 사용할 수 있도록 하는 것이 다음 목표입니다. 현재로서는 Unity 에디터에서만 작동합니다.

이 시스템은 확장성이 뛰어납니다. Unity 프로젝트 코드베이스에서 직접 사용자 지정 tool 를 정의하여 AI 또는 자동화 클라이언트에 새로운 기능을 제공할 수 있습니다. 따라서 Unity-MCP는 고급 워크플로 구축, 신속한 프로토타입 제작 또는 AI 기반 기능을 개발 프로세스에 통합하기 위한 유연한 기반을 제공합니다.

AI 도구

게임 객체

• ✅ 만들기

• ✅ 파괴하다

• ✅ 찾기

• ✅ 수정(태그, 레이어, 이름, 정적)

• ✅ 부모 설정

• ✅ 복제

게임 객체.구성 요소

• ✅ 구성 요소 추가

• ✅ 구성 요소 가져오기

• ✅ 구성 요소 수정

• • ✅ Field 설정 값

• • ✅ Property 설정 값

• • ✅ Reference 링크 세트

• ✅ 구성 요소 파괴

• 🔲 누락된 구성 요소를 제거하세요

편집자

• ✅ 상태(플레이모드)

  • ✅ 받으세요

  • ✅ 세트

• ✅ Windows 받기

• ✅ 레이어

  • ✅ 모두 받기

  • ✅ 추가

  • ✅ 제거

• ✅ 태그

  • ✅ 모두 받기

  • ✅ 추가

  • ✅ 제거

• ✅ MenuItem 실행

• 🔲 테스트 실행

편집자 선택

• ✅ 선택하기

• ✅ 선택 설정

프리팹

• ✅ 인스턴스화

• 🔲 만들기

• ✅ 오픈

• ✅ 수정(GameObject.Modify)

• ✅ 저장

• ✅ 닫기

패키지

• 🔲 설치하기

• 🔲 설치

• 🔲 제거

• 🔲 업데이트

자산

• ✅ 만들기

• ✅ 찾기

• ✅ 새로고침

• ✅ 읽기

• ✅ 수정

• ✅ 이름 바꾸기

• ✅ 삭제

• ✅ 이동

• ✅ 폴더 생성

장면

• ✅ 만들기

• ✅ 저장

• ✅ 로드

• ✅ 언로드

• ✅ 로드하세요

• ✅ 계층 구조 가져오기

• 🔲 검색(편집기)

• 🔲 레이캐스트(볼륨 이해)

재료

• ✅ 만들기

• ✅ 수정(Assets.Modify)

• ✅ 읽기(Assets.Read)

• ✅ 게임 객체의 구성 요소에 할당

셰이더

• ✅ 모두 나열

스크립트

• ✅ 읽기

• ✅ 업데이트 또는 생성

• ✅ 삭제

스크립트 가능 객체

• 🔲 만들기

• 🔲 읽기

• 🔲 수정

• 🔲 제거

디버그

• 🔲 로그 읽기(콘솔)

요소

• ✅ 모두 받기

범례: ✅ = 구현 및 사용 가능, 🔲 = 계획됨/아직 구현되지 않음

설치

1. .NET 9.0 설치

2. OpenUPM-CLI 설치

• Unity 프로젝트 폴더에서 명령줄 열기

• 명령을 실행하세요

지엑스피1

용법

1. 프로젝트 경로에 공백 기호 " "가 없는지 확인하세요.

• ✅ C:/MyProjects/Project

• ❌ C:/My Projects/Project

2. Unity 프로젝트를 열고 👉 Window/AI Connector (Unity-MCP) 로 이동합니다.

3. MCP 클라이언트 설치

• 커서 설치 (권장)

• Claude 설치

4. MCP 클라이언트에 로그인

5. MCP 클라이언트에서 Configure 클릭합니다.

6. MCP 클라이언트를 다시 시작합니다.

7. 재시작 후 AI Connector 가 "연결됨" 또는 "연결 중..." 상태인지 확인하세요.

8. 클라이언트(커서, Claude Desktop)에서 AI 연결을 테스트하세요. 채팅에 질문이나 작업을 입력하세요. 다음과 같은 내용을 입력하세요.

사용자 정의 tool 추가

⚠️ 동적 도구 목록 업데이트를 지원하는 MCP 클라이언트에서만 작동합니다.

Unity-MCP는 프로젝트 소유자의 맞춤형 tool 개발을 지원하도록 설계되었습니다. MCP 서버는 Unity 플러그인에서 데이터를 가져와 클라이언트에 노출합니다. 따라서 MCP 통신망에 있는 모든 사용자는 새 tool 에 대한 정보를 받게 됩니다. LLM은 어느 시점에 호출할지 결정할 수 있습니다.

사용자 정의 tool 추가하려면 다음이 필요합니다.

1. McpPluginToolType 속성이 있는 클래스를 갖습니다.

2. McpPluginTool 속성이 있는 클래스에 메서드를 갖습니다.

3. [선택 사항] LLM에서 이해할 수 있도록 각 메서드 인수에 Description 속성을 추가합니다.

4. [선택 사항] string? optional = null 속성을 ? 와 기본값과 함께 사용하여 LLM에 대한 optional 으로 표시합니다.

MainThread.Run(() => 줄을 살펴보세요. 이 줄은 Unity API와 상호 작용하는 데 필요한 코드를 메인 스레드에서 실행할 수 있도록 해줍니다. 메인 스레드가 필요하지 않고 도구를 백그라운드 스레드에서 실행해도 괜찮다면, 효율성을 위해 메인 스레드는 사용하지 마세요.

사용자 정의 게임 내 tool 추가

⚠️ 아직 지원되지 않습니다. 작업 중입니다.

기부금

프로젝트에 새로운 tool 자유롭게 추가하세요.

1. 프로젝트를 포크하세요.

2. 포크된 저장소에 새로운 tool 구현합니다.

3. 원래 Unity-MCP 저장소에 풀 리퀘스트를 생성합니다.