DesyncedMCP

Desynced 모드 개발을 위한 MCP 서버입니다. AI 어시스턴트(Claude Code 또는 모든 MCP 클라이언트)에게 게임의 Lua API 레퍼런스, 기본 게임 소스, 실시간 게임 로그, 설치된 모드에 대한 직접 접근 권한을 제공합니다.

도구

정적(파일 시스템)

실시간(lrdb 디버거 링크, -moddev로 실행 중인 게임)

링크는 satoren lrdb 프로토콜(개행으로 구분된 JSON-RPC, init 없음)을 사용하여 127.0.0.1:21110과 통신합니다. 게임의 디버그 서버는 단일 클라이언트에서만 명령을 받습니다: 이 서버가 링크되어 있는 동안 게임 내 로그 콘솔은 조용해지고(출력이 링크로 리디렉션됨) VS Code는 연결할 수 없습니다. VM은 Lua가 실행되는 동안에만 eval에 응답하므로, 유휴 메뉴에서는 시간 초과가 발생할 수 있습니다.

Related MCP server: Roblox MCP Server

시뮬레이션 브리지(동반 모드)

game_eval은 게임의 UI Lua VM에서 실행되며, 시뮬레이션 변경은 차단됩니다. 게임 제어(이동, 배치, 채굴, 건설 등)에는 동반 모드 Desynced MCP Bridge on the Steam Workshop이 필요하며, 이 모드는 FactionAction.MCPSimCmd를 시뮬레이션 컨텍스트에 노출합니다. 이 서버는 읽기 전용 도구(로그, 상태, eval 읽기, 핫 리로드)에는 이 모드 없이도 작동합니다.

설정

npm install
npm test   # smoke test

Claude Code에 등록(프로젝트 범위):

claude mcp add desynced --scope project -- node <path-to>/DesyncedMCP/server.js

구성(환경 변수)

기본 게임 검색(선택 사항)

게임은 전체 기본 게임을 main.zip으로 모드 폴더 안에 제공하며 항상 압축된 상태로 로드합니다. 일반 설치에서는 압축이 풀리지 않습니다. search_game_source와 read_game_file이 기본 게임 Lua를 볼 수 있게 하려면, 아무 zip 도구로 main.zip을 작업 공간 안의 main/ 폴더에 압축 해제하세요. 이는 순전히 개발 편의를 위한 것입니다. 게임은 압축 해제된 복사본을 필요로 하지도 않고 사용하지도 않습니다.

게임 측 요구 사항

서버 자체는 게임 외부에서 실행됩니다. 게임에 설치할 것은 없습니다. 로그가 존재하려면 다음 Steam 실행 옵션으로 Desynced를 실행하세요:

-moddev -log

-moddev는 모드 개발자 모드를 활성화합니다(F7 핫 리로드, 엄격한 데이터 검사, 로그 콘솔). -log는 이 서버가 읽는 로그 파일을 작성합니다.

로드맵

• deploy_mod: 작업 공간 모드를 게임 모드 디렉터리에 복사(수동 복사 단계 대체)

• lrdb 디버그 프로토콜(-moddev의 localhost:21110)을 통한 실시간 브리지: 실행 중인 게임에서 Lua eval, 엔티티/진영 검사, Debug.Reload() 트리거

• DesyncedModUploader를 통한 Workshop 게시