Repolode
CoderGamester

CoderGamester/mcp-unity

Cursor, Claude Code, Codex 같은 AI 코딩 어시스턴트가 Unity Editor를 제어하고 조회할 수 있게 해주는 Model Context Protocol(MCP) 플러그인입니다.

스타
1,943
포크
247
열린 이슈
7
마지막 커밋
9일 전

어떤 프로젝트인가요?

MCP Unity는 Unity Editor와 Model Context Protocol을 구현하는 Node.js 서버를 연결하는 브리지입니다. Editor 내부에서 WebSocket 서버가 실행되고, Node.js 측에서는 Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot, OpenCode 같은 AI 클라이언트의 요청을 Unity로 전달합니다.

연결하면 AI 어시스턴트가 메뉴 항목을 실행하고, GameObject와 컴포넌트를 생성·업데이트하고, 오브젝트를 이동하거나 회전하고, 씬과 프리팹을 관리하고, 머티리얼을 편집하고, 패키지를 설치하고, Unity Test Runner 테스트를 실행하고, 콘솔 로그를 읽을 수 있습니다. 씬 계층 구조, 에셋, 패키지, 테스트 목록을 위한 리소스도 제공하며, 한 번의 요청으로 여러 작업을 실행하는 배치 도구도 포함합니다.

이 패키지는 Git URL을 통해 Unity Package Manager에서 설치합니다. Editor의 Server Window에서 프로젝트 로컬 또는 전역 옵션을 선택해 설정을 생성할 수 있습니다. 안전을 위해 패키지 설치와 배치 모드 시작은 기본적으로 비활성화되어 있으며, 프로젝트별 인증 토큰으로 연결을 보호합니다.

핵심 기능

  • 01GameObject, 컴포넌트, 트랜스폼, 머티리얼 관련 작업을 AI 어시스턴트에 제공합니다.
  • 02Test Runner를 통해 Unity 메뉴 항목과 EditMode/PlayMode 테스트를 실행합니다.
  • 03콘솔 로그, 씬 계층 구조, 에셋, 설치된 패키지를 MCP 리소스로 읽어옵니다.
  • 04씬 로드, 저장, 언로드와 Play Mode 상태를 제어합니다.
  • 05한 번의 요청으로 여러 작업을 배치 실행할 수 있습니다.
  • 06Cursor, Claude Code, Codex CLI, Copilot, OpenCode용 클라이언트 설정을 생성합니다.

활용 사례

  • 자연어로 설명하는 동안 AI 코딩 어시스턴트가 씬 오브젝트, 프리팹, 머티리얼을 설정하도록 합니다.
  • AI 채팅에서 Unity 테스트를 실행하고 콘솔에서 실패 내용을 확인합니다.
  • Editor에서 일일이 클릭하지 않고 여러 GameObject를 한꺼번에 만들거나 이름을 변경합니다.
  • 씬 계층 구조와 에셋을 조회해 팀원들이 익숙하지 않은 Unity 프로젝트를 파악하도록 돕습니다.

빠른 시작

  1. 1

    Node.js 다운로드 페이지에서 Node.js 18 이상을 설치합니다

  2. 2

    Unity Package Manager(Window > Package Manager)를 통해 Unity MCP Server 패키지를 설치합니다

  3. 3

    Node.js가 설치되어 있는지 확인합니다

    node --version

사용 전 알아둘 점

  • Unity 6 이상 및 Node.js 18 이상이 필요합니다.
  • 경로에 공백이 포함된 프로젝트는 연결 문제가 발생할 수 있습니다.

토픽

자주 묻는 질문

mcp-unity은(는) 무엇인가요?
Cursor, Claude Code, Codex 같은 AI 코딩 어시스턴트가 Unity Editor를 제어하고 조회할 수 있게 해주는 Model Context Protocol(MCP) 플러그인입니다. MCP Unity는 Unity Editor와 Model Context Protocol을 구현하는 Node.js 서버를 연결하는 브리지입니다. Editor 내부에서 WebSocket 서버가 실행되고, Node.js 측에서는 Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot, OpenCode 같은 AI 클라이언트의 요청을 Unity로 전달합니다.
mcp-unity은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
mcp-unity은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
mcp-unity은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. mcp-unity의 마지막 커밋은 2026년 10월 11일입니다.
mcp-unity은(는) 어디에 사용할 수 있나요?
자연어로 설명하는 동안 AI 코딩 어시스턴트가 씬 오브젝트, 프리팹, 머티리얼을 설정하도록 합니다. AI 채팅에서 Unity 테스트를 실행하고 콘솔에서 실패 내용을 확인합니다. Editor에서 일일이 클릭하지 않고 여러 GameObject를 한꺼번에 만들거나 이름을 변경합니다. 씬 계층 구조와 에셋을 조회해 팀원들이 익숙하지 않은 Unity 프로젝트를 파악하도록 돕습니다.
mcp-unity는 어떻게 설치하나요?
Node.js 다운로드 페이지에서 Node.js 18 이상을 설치합니다 Unity Package Manager(Window > Package Manager)를 통해 Unity MCP Server 패키지를 설치합니다 Node.js가 설치되어 있는지 확인합니다: node --version
mcp-unity은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/CoderGamester/mcp-unity

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트