A
securityA
licenseA
qualityMCP Unity Server to integrate Unity Editor game engine with different AI Model clients (e.g. Claude Desktop, Windsurf, Cursor)
Last updated -
5
647
MIT License
Unity MCP(서버 + 플러그인)
| 유니티 버전 | 편집모드 | 플레이모드 | 독립형 |
|---|---|---|---|
| 2022년 3월 61일 | |||
| 2023.2.20f1 | |||
| 6000.0.46f1 |
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)
- ✅ 게임 객체의 구성 요소에 할당
셰이더
- ✅ 모두 나열
스크립트
- ✅ 읽기
- ✅ 업데이트 또는 생성
- ✅ 삭제
스크립트 가능 객체
- 🔲 만들기
- 🔲 읽기
- 🔲 수정
- 🔲 제거
디버그
- 🔲 로그 읽기(콘솔)
요소
- ✅ 모두 받기
범례: ✅ = 구현 및 사용 가능, 🔲 = 계획됨/아직 구현되지 않음
설치
- Unity 프로젝트 폴더에서 명령줄 열기
- 명령을 실행하세요
지엑스피1
용법
- 프로젝트 경로에 공백 기호 " "가 없는지 확인하세요.
- ✅
C:/MyProjects/Project- ❌
C:/My Projects/Project
- Unity 프로젝트를 열고 👉
Window/AI Connector (Unity-MCP)로 이동합니다.
- MCP 클라이언트 설치
- MCP 클라이언트에 로그인
- MCP 클라이언트에서
Configure클릭합니다.
- MCP 클라이언트를 다시 시작합니다.
- 재시작 후
AI Connector가 "연결됨" 또는 "연결 중..." 상태인지 확인하세요. - 클라이언트(커서, Claude Desktop)에서 AI 연결을 테스트하세요. 채팅에 질문이나 작업을 입력하세요. 다음과 같은 내용을 입력하세요.
사용자 정의 tool 추가
⚠️ 동적 도구 목록 업데이트를 지원하는 MCP 클라이언트에서만 작동합니다.
Unity-MCP는 프로젝트 소유자의 맞춤형 tool 개발을 지원하도록 설계되었습니다. MCP 서버는 Unity 플러그인에서 데이터를 가져와 클라이언트에 노출합니다. 따라서 MCP 통신망에 있는 모든 사용자는 새 tool 에 대한 정보를 받게 됩니다. LLM은 어느 시점에 호출할지 결정할 수 있습니다.
사용자 정의 tool 추가하려면 다음이 필요합니다.
McpPluginToolType속성이 있는 클래스를 갖습니다.McpPluginTool속성이 있는 클래스에 메서드를 갖습니다.- [선택 사항] LLM에서 이해할 수 있도록 각 메서드 인수에
Description속성을 추가합니다. - [선택 사항]
string? optional = null속성을?와 기본값과 함께 사용하여 LLM에 대한optional으로 표시합니다.
MainThread.Run(() =>줄을 살펴보세요. 이 줄은 Unity API와 상호 작용하는 데 필요한 코드를 메인 스레드에서 실행할 수 있도록 해줍니다. 메인 스레드가 필요하지 않고 도구를 백그라운드 스레드에서 실행해도 괜찮다면, 효율성을 위해 메인 스레드는 사용하지 마세요.
사용자 정의 게임 내 tool 추가
⚠️ 아직 지원되지 않습니다. 작업 중입니다.
기부금
프로젝트에 새로운 tool 자유롭게 추가하세요.
- 프로젝트를 포크하세요.
- 포크된 저장소에 새로운
tool구현합니다. - 원래 Unity-MCP 저장소에 풀 리퀘스트를 생성합니다.
This server cannot be installed
Unity 프로젝트에 대한 원활한 자동화 및 지능형 제어 기능을 제공합니다. MCP 서버 및 클라이언트와 통합되어 AI 에이전트 또는 외부 도구가 Unity 환경과 상호 작용하여 게임 오브젝트, 컴포넌트, 에셋, 씬 등을 생성, 수정 및 관리할 수 있습니다.
Related MCP Servers
- -securityAlicense-qualityA Unity Master Control Protocol implementation that allows AI agents to control and interact with Unity, enabling them to execute code, query editor state, modify GameObjects, and capture screenshots through a WebSocket-based communication system.Last updated -7MIT License
- -securityFlicense-qualityUnreal-Blender MCP is a unified server for controlling both Blender and Unreal Engine via AI agents using the MCP (Machine Control Protocol) approach.Last updated -Python
- -securityAlicense-qualityAn MCP server that bridges AI agents with GUI automation capabilities, allowing them to control mouse, keyboard, windows, and take screenshots to interact with desktop applications.Last updated -PythonMIT License