프로젝트 소개

nexus-vscode는 VSCode / Cursor용 MCP(Model Context Protocol) 프록시 확장입니다. 로컬에서 HTTP 서버(기본 포트 6900)를 실행하여 Unreal Engine(UE) 인스턴스를 자동으로 발견하고, WebSocket을 통해 AI 도구 호출을 NexusLink로 전달합니다. 이 확장 자체는 게임 로직을 구현하지 않으며, 블루프린트, 에셋 관리, PIE 등의 구체적인 기능은 UE 측의 NexusLink에서 제공합니다. 주요 기능 및 특징: 1. 인스턴스 발견: 지정된 포트 범위 내에서 UE 인스턴스를 자동으로 스캔하거나 원격 UE 인스턴스를 구성할 수 있습니다. 2. 프록시 전달: Cursor, CodeBuddy, Windsurf 등의 AI 클라이언트 요청을 UE 측으로 전달합니다. 3. 권한 및 보안: Bearer Token 인증을 지원하며, 쓰기 게이트(Write Gate) 설정(off / destructive / all)을 제공하여 파괴적인 작업을 제어합니다. 4. 구성 편의성: mcp.json 구성과 인증 토큰을 한 번에 복사하는 명령을 제공하여 AI 클라이언트 통합 과정을 간소화합니다. 5. 상태 관리: 상태 표시줄에서 연결 상태를 표시하고, 수동으로 새로 고침, 선택 또는 UE 인스턴스 연결 해제를 지원하며, Agent 전달을 일시 중지/재개할 수 있습니다. 의존성 요구 사항: - NexusLink를 설치하고 활성화해야 합니다(UE 4.26+ 지원). - VS Code Engine 버전은 ^1.85.0 이상이어야 합니다.