Files
2nd/00_Raw/2026-04-25-Datacollector_Mac_Windows_Launcher_Scripts.md
T
Antigravity Agent 206875badc chore: Initialize environment for new Wiki categories
- Created Index.md for Topics_Art, Topics_Biz, Topics_Blog, Topics_GD\n- Established P-Reinforce entry points for specialized knowledge domains
2026-04-25 21:54:53 +09:00

1.4 KiB

Datacollector Mac Windows Launcher Scripts

Date: 2026-04-25 21:09:42 KST Project: Datacollector Repository: /Volumes/Data/project/Antigravity/Datacollector

Summary

Datacollector 실행 시 Vite 프런트엔드만 뜨고 MCP Bridge 서버가 뜨지 않아 ERR_CONNECTION_REFUSED가 발생할 수 있었다.
이를 막기 위해 맥용과 윈도우용 실행 파일을 명확히 정리했다.

Main Launchers

  • macOS: /Volumes/Data/project/Antigravity/Datacollector/run_mac.command
  • Windows: /Volumes/Data/project/Antigravity/Datacollector/run_win.bat

두 실행 파일 모두 아래를 수행한다.

  1. 프로젝트 폴더로 이동
  2. node_modules가 없으면 npm install
  3. 기존 3000, 3002 포트 프로세스 정리
  4. MCP Bridge 서버 실행
  5. Vite 앱 실행

Compatibility Wrappers

기존 실행 파일과의 호환성을 위해 아래 파일은 메인 실행 파일로 위임하도록 단순화했다.

  • run_app.sh -> run_mac.command
  • run_app.bat -> run_win.bat

Verification

실행한 검증:

bash -n run_mac.command
bash -n run_app.sh
npm run lint

검증 결과:

  • macOS shell script 문법 통과
  • TypeScript 타입체크 통과

Operational Note

앞으로 맥에서는 run_mac.command, 윈도우에서는 run_win.bat만 실행하면 된다.
npm run dev 단독 실행은 프런트엔드만 켜므로 NotebookLM, Wiki save, 인증 복구 API가 동작하지 않는다.