기본 패턴
text
README 기준 빠른 흐름
1. Unity에 패키지 설치
2. Unity에서 MCP for Unity 창 열기
3. 서버 시작 후 MCP 클라이언트 연결
4. 에이전트가 Unity 도구를 호출
핵심 포인트
- localhost:8080 기반 MCP 엔드포인트
- 에셋, 씬, 스크립트, 테스트, 콘솔 읽기까지 폭넓은 도구 제공
- 여러 Unity 인스턴스를 resource + tool로 선택 가능설명
unity-mcp는 Unity 에디터를 MCP 서버처럼 노출해, 에이전트가 자연어 뒤에서 구조화된 Unity 도구를 호출할 수 있게 만드는 커뮤니티 프로젝트입니다.- README 기준으로 에셋 관리, 씬 조작, 게임오브젝트 검색, 스크립트 생성과 수정, 콘솔 읽기, 테스트 실행, Unity 문서 참조 같은 도구가 폭넓게 준비되어 있습니다.
- Codex 관점에서 장점은 "셸 명령 몇 개"가 아니라, Unity 작업이 도구 단위로 분해되어 더 구조적으로 위임된다는 점입니다.
- 여러 Unity 인스턴스를 다룰 때는
unity_instances같은 리소스를 먼저 확인하고set_active_instance로 대상을 고르는 흐름이 지원되어, 멀티 프로젝트 환경에서도 비교적 명시적으로 작업할 수 있습니다. - 반면 MCP 클라이언트 설정, Unity 패키지 설치, 로컬 서버 구동 같은 준비 단계가 있으므로, 가볍게 몇 줄 명령만 던지고 싶은 경우보다 "도구 중심 워크플로우"를 만들고 싶을 때 더 잘 맞습니다.
빠른 정리
| 관점 | unity-mcp의 특징 |
|---|---|
| 접근 방식 | Unity를 MCP 도구 집합으로 노출 |
| 잘 맞는 경우 | 에이전트가 Unity를 구조화된 툴 호출로 다루게 하고 싶을 때 |
| 강점 | 씬, 에셋, 스크립트, 테스트, 콘솔 등 넓은 작업 범위 |
| 준비물 | Unity 패키지 설치, MCP 클라이언트 연결 |
| 멀티 인스턴스 | 리소스 조회 후 활성 인스턴스 전환 지원 |
주의할 점
이 프로젝트는 OpenAI나 Unity의 공식 도구가 아니라 커뮤니티 저장소입니다. Codex와 연결해 쓰기 전에는 어떤 도구가 파일과 에디터 상태를 바꾸는지, 현재 팀의 작업 방식과 권한 모델에 맞는지 먼저 검토하는 편이 안전합니다.
참고 링크
1 sources