A
security-
licenseA
qualityMCP Unity Server to integrate Unity Editor game engine with different AI Model clients (e.g. Claude Desktop, Windsurf, Cursor)
Last updated -
5
1,016
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 연결을 테스트하세요. 채팅에 질문이나 작업을 입력하세요. 다음과 같은 내용을 입력하세요.
Explain my scene hierarchy
사용자 정의 tool 추가
⚠️ 동적 도구 목록 업데이트를 지원하는 MCP 클라이언트에서만 작동합니다.
Unity-MCP는 프로젝트 소유자의 맞춤형 tool 개발을 지원하도록 설계되었습니다. MCP 서버는 Unity 플러그인에서 데이터를 가져와 클라이언트에 노출합니다. 따라서 MCP 통신망에 있는 모든 사용자는 새 tool 에 대한 정보를 받게 됩니다. LLM은 어느 시점에 호출할지 결정할 수 있습니다.
사용자 정의 tool 추가하려면 다음이 필요합니다.
McpPluginToolType속성이 있는 클래스를 갖습니다.McpPluginTool속성이 있는 클래스에 메서드를 갖습니다.[선택 사항] LLM에서 이해할 수 있도록 각 메서드 인수에
Description속성을 추가합니다.[선택 사항]
string? optional = null속성을?와 기본값과 함께 사용하여 LLM에 대한optional으로 표시합니다.
MainThread.Run(() =>줄을 살펴보세요. 이 줄은 Unity API와 상호 작용하는 데 필요한 코드를 메인 스레드에서 실행할 수 있도록 해줍니다. 메인 스레드가 필요하지 않고 도구를 백그라운드 스레드에서 실행해도 괜찮다면, 효율성을 위해 메인 스레드는 사용하지 마세요.
[McpPluginToolType]
public class Tool_GameObject
{
[McpPluginTool
(
"MyCustomTask",
Title = "Create a new GameObject"
)]
[Description("Explain here to LLM what is this, when it should be called.")]
public string CustomTask
(
[Description("Explain to LLM what is this.")]
string inputData
)
{
// do anything in background thread
return MainThread.Run(() =>
{
// do something in main thread if needed
return $"[Success] Operation completed.";
});
}
}
사용자 정의 게임 내 tool 추가
⚠️ 아직 지원되지 않습니다. 작업 중입니다.
기부금
프로젝트에 새로운 tool 자유롭게 추가하세요.
프로젝트를 포크하세요.
포크된 저장소에 새로운
tool구현합니다.원래 Unity-MCP 저장소에 풀 리퀘스트를 생성합니다.
This server cannot be installed
Unity 프로젝트에 대한 원활한 자동화 및 지능형 제어 기능을 제공합니다. MCP 서버 및 클라이언트와 통합되어 AI 에이전트 또는 외부 도구가 Unity 환경과 상호 작용하여 게임 오브젝트, 컴포넌트, 에셋, 씬 등을 생성, 수정 및 관리할 수 있습니다.
Related MCP Servers
- -security-license-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.
- -security-license-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 -7
- -security-license-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 -10MIT License