rct2-agent

MCP 서버 + OpenRCT2 플러그인입니다. 여러분이 플레이하는 동안 에이전트가 공원을 사이드카 방식으로 관리할 수 있게 해 줍니다: 상태 읽기, 운영(가격, 직원, 마케팅, 대출) 처리, 공원 보기(스크린샷), 시간 제어. 관리 전용입니다 — 에이전트는 사업을 조정하고 건설을 추천할 수는 있지만, 실제로 건설하지는 않습니다.

구성 방식

Claude Code (WSL)
      │ stdio (MCP)
      ▼
MCP server  ── dist/server.mjs, run by Windows node.exe
      │ TCP 127.0.0.1:7860  (newline-delimited JSON)
      ▼
Plugin (intransient) ── loaded inside OpenRCT2, LISTENS on the port
      │
      ▼
   OpenRCT2 game

서버는 Windows의 node.exe에서 실행됩니다(WSL에는 node가 없음). 따라서 서버와 플러그인 모두 같은 Windows localhost에 있습니다 — WSL↔Windows 네트워킹은 필요 없습니다. 플러그인은 대기하며(임시 실행이 아니라, 공원을 불러와도 계속 살아 있습니다), 서버는 접속하여 필요할 때마다 다시 연결합니다.

Related MCP server: Roblox Executor MCP

요구 사항

• OpenRCT2 0.4.4+(QuickJS 엔진 — Promises/ES2023 필요).

• Windows Node.js(C:\Program Files\nodejs\node.exe에 있습니다).

빌드 및 설치

WSL에서, Windows 툴체인을 사용하여:

# helper wrappers (or just call node.exe / npm-cli.js directly)
NODE="/mnt/c/Program Files/nodejs/node.exe"
NPM=("$NODE" "C:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npm-cli.js")

"${NPM[@]}" install
"${NPM[@]}" run build          # builds dist/rct2-agent.plugin.js + dist/server.mjs
"${NPM[@]}" run install:plugin # copies the plugin into your OpenRCT2 plugin folder

install:plugin은 C:\Users\casey\OneDrive\Documents\OpenRCT2\plugin\rct2-agent.plugin.js에 복사합니다(RCT2_PLUGIN_DIR로 재정의 가능).

MCP 서버 연결

바로 쓸 수 있는 프로젝트 구성이 .mcp.json에 들어 있습니다. Claude Code에서 프로젝트 디렉터리에 있으면 자동으로 인식됩니다(메시지가 나오면 승인). 아니면 명시적으로 추가하세요:

claude mcp add rct2-agent --scope project \
  -- "/mnt/c/Program Files/nodejs/node.exe" \
     "C:\\Users\\casey\\OneDrive\\Desktop\\dead code projects\\rct2-agent\\dist\\server.mjs"

실행

1. OpenRCT2를 실행하고 시나리오를 불러오세요. 플러그인이 로드되었는지 확인하세요. 게임 내 콘솔에 [rct2-agent] listening on 127.0.0.1:7860라고 표시됩니다.

2. 이 폴더에서 Claude Code를 시작하세요. MCP 서버는 첫 번째 도구 호출 시 연결됩니다.

3. 에이전트에게 공원 관리를 요청하세요. 핵심 루프는 측정 → 조치 → 대기 → 측정입니다: 기준값으로 측정하고, 변경하고, advance_days(7) 실행한 뒤 다시 측정합니다.

도구

읽기(눈): get_park_summary, get_finance_report, list_rides, get_ride, list_shops, get_guest_overview, sample_guest_thoughts, list_staff, get_scenario

조작(손): set_ride_price, set_shop_price, set_park_entry_fee, open_ride, close_ride, set_inspection_interval, start_marketing_campaign, set_research_funding, hire_staff, fire_staff, set_staff_patrol, set_loan

보기(시야): capture_view, capture_ride, find_location

시간: get_clock, set_game_speed, pause, resume, advance_days

저장: snapshot, list_snapshots

동작 참고 사항

• 돈은 도구 경계에서 일반 달러 단위입니다. OpenRCT2는 내부적으로 10분의 1달러 단위로 저장하며, 이를 src/shared/protocol.ts에서 변환합니다(MONEY_FACTOR). 값이 10배 어긋나 보인다면 이 함수 하나를 확인하면 됩니다.

• capture_view / set_staff_patrol / find_location의 좌표는 타일 단위입니다(내부적으로 맵 단위로 변환됨).

• **advance_days**는 일시정지를 해제하고 최대 속도로 진행하다가 목표 날짜에 도달하면 자동 일시정지합니다. 그리고 새로운 시계를 반환합니다. 완료될 때까지 블로킹합니다.

• 스냅샷은 save/agent/<play>/<label>.park에 저장됩니다. 복원은 수동 Load로 불러와야 합니다 — 플러그인 API는 저장은 할 수 있어도 로드는 할 수 없습니다.

• 쓰기는 게임 액션을 거치므로 게임 자체의 제한이 적용됩니다(예: 놀이기구 가격 상한). 거부된 액션은 도구 오류로 반환됩니다.

개발

• npm run typecheck — tsc, 출력 없음.

• node scripts/smoke.mjs — 빌드한 플러그인을 스텁된 게임에 불러온 뒤, 실제 소켓으로 핸들러를 테스트합니다.

• node scripts/mcp-smoke.mjs — 빌드한 MCP 서버를 직접 띄워 가짜 플러그인에게 실제 MCP JSON-RPC로 구동합니다.

구조

src/shared/protocol.ts   wire protocol + money conversion + method names
src/plugin/main.ts       the intransient in-game plugin (TCP listener + handlers)
src/server/rct-client.ts reconnecting TCP client to the plugin
src/server/index.ts      MCP server: tool definitions -> plugin methods
esbuild.mjs              builds both bundles
scripts/                 install + smoke tests