유니티 MCP 서버

Unity 게임 개발을 위한 MCP(Model Context Protocol) 서버로, AI 어시스턴트가 일련의 전문 도구를 통해 Unity 프로젝트와 상호 작용할 수 있도록 해줍니다.

개요

Unity MCP 서버는 AI 어시스턴트(예: Cursor AI 또는 Claude)와 Unity 프로젝트를 연결하는 다리 역할을 합니다. 다음과 같은 도구를 제공합니다.

Unity 프로젝트에서 파일 읽기 및 검색
Unity 장면 및 프리팹 구문 분석
C# 코드 분석 및 오류 감지
일괄 모드에서 자동화 테스트 실행
템플릿에서 스크립트 생성
셰이더 검증
그리고 더 많은 것...

이 서버는 Unity와 함께 배치 모드로 실행되도록 설계되어 편집기 GUI가 필요 없이 Unity 엔진이 필요한 작업이 가능합니다.

설치

필수 조건

노드.js 16+
Unity 2022.3 LTS 이상(권장)

설정

이 저장소를 복제하세요:지엑스피1
종속성 설치:
npm install
프로젝트를 빌드하세요:
npm run build

구성

서버는 구성에 config 패키지를 사용합니다. config/default.json 파일을 편집하여 설정을 조정하세요.

{
  "server": {
    "port": 3000,
    "host": "0.0.0.0"
  },
  "unity": {
    "unityPath": "/path/to/Unity/Editor/Unity",
    "projectPath": "/path/to/your/unity/project",
    "timeoutMs": 60000,
    "batchMode": true
  },
  "logging": {
    "level": "info",
    "file": "logs/mcp-server.log",
    "maxSize": 5242880,
    "maxFiles": 5
  },
  "security": {
    "allowedPaths": ["Assets", "ProjectSettings", "Packages"],
    "disallowedCommands": ["rm", "del", "format", "shutdown"]
  }
}

용법

서버 시작

npm start

Smithery 모드로 실행하려면:

npm run smithery:start

AI 어시스턴트와 함께 사용

이 서버는 주로 MCP 사양에 정의된 도구를 통해 AI 어시스턴트와 연동하도록 설계되었습니다. Cursor 또는 Smithery.ai 통합의 경우, 해당 설명서를 참조하여 이 MCP 서버에 연결하세요.

사용 가능한 도구

도구 이름	설명
`open_file`	Unity 프로젝트의 파일 내용을 읽습니다.
`search_files`	프로젝트 파일에서 텍스트 패턴 검색
`list_assets`	특정 유형 또는 폴더의 프로젝트 자산을 나열합니다.
`get_project_info`	Unity 프로젝트에 대한 고급 정보를 얻습니다.
`parse_scene`	게임 객체 계층을 추출하기 위해 Unity 장면 파일을 구문 분석합니다.
`parse_prefab`	Unity 프리팹 파일을 구문 분석하여 구성 요소를 추출합니다.
`find_in_scenes`	특정 GameObject 또는 구성 요소를 포함하는 장면을 찾습니다.
`analyze_cs_code`	컴파일러 오류를 찾기 위해 C# 코드를 컴파일합니다.
`find_references`	C# 클래스 또는 메서드에 대한 참조를 찾습니다.
`generate_script`	템플릿에서 새 C# 스크립트 파일을 만듭니다.
`validate_shader`	셰이더를 컴파일하고 오류를 보고합니다.
`inspect_yaml`	YAML 자산 파일을 검사합니다.
`run_tests`	Unity의 자동화된 테스트를 일괄 모드로 실행합니다.
`simulate_playmode`	실험적 - 짧은 시간 동안 재생 모드에서 장면을 실행합니다.

도커 지원

컨테이너화된 배포를 위해 Dockerfile이 포함되어 있습니다. Docker 이미지를 빌드하세요.

docker build -t unity-mcp-server .

컨테이너를 실행합니다.

docker run -p 3000:3000 -v /path/to/unity/project:/project unity-mcp-server

Smithery.ai 통합

제공된 smithery.yaml 구성을 사용하여 이 서버를 Smithery.ai에 배포할 수 있습니다.

특허

MIT

기여하다

기여를 환영합니다! 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.

Unity MCP Server

Integrations