v0.1.0-rc.6

What's Changed

Refactoring

• electron/index.ts (567줄) 분리: types.ts, cdp.ts, discovery.ts, execute.ts, connection-pool.ts로 분리
• constants.ts: 타임아웃, 포트, 저장 한도 등 상수 중앙 관리
• logger.ts: LOG_LEVEL 환경변수 기반 구조적 로거
• NavigationBucketStore: console/network 중복 패턴 추출
• connection-pool.ts: CDP WebSocket 커넥션 풀
• discovery.ts: 중복 코드 헬퍼 추출

New Features

• emulation.ts 실 구현: 다크/라이트 모드, CPU 스로틀링, 지오로케이션, 네트워크 조건, UA, 뷰포트, 타임존, 로케일
• 콘솔 객체 탐색 개선: JSON.stringify → Runtime.getProperties 재귀 탐색
  • 순환 참조 안전 ([Circular])
  • Symbol, Function, Promise, Map, Set 등 정확히 표현
  • MAX_RESOLVE_DEPTH=5 / MAX_PROPERTIES=50

Tests

• 유닛 테스트 4개 추가 (총 61개 테스트, 135 expect 통과)

v0.1.0-rc.4: fix(config): Zod를 번들에서 제외해 util3 ReferenceError 제거

v0.1.0-rc.4

콘솔 로깅 개선 및 CI(번들) 수정이 포함된 릴리즈입니다.

설치

npm install -g @ohah/electron-mcp-server
# 또는
npx -y @ohah/electron-mcp-server

변경 사항

• 콘솔 로깅: Runtime.consoleAPICalled 기반으로 콘솔 메시지 수집 시 인자 객체를 직렬화해 풍부하게 표시
• CI·번들 수정: Zod를 번들에서 제외(external)해 util3 is not defined ReferenceError 제거. zod를 dependencies로 이동해 npx 설치 시 런타임 의존성 확보

요구 사항

• Node.js >=24 또는 Bun >=1.0.0
• Electron 앱은 --remote-debugging-port=9222 필요

v0.1.0-rc.3 대비

• rc.3: 메인 프로세스 IPC/네트워크 모니터, 콘솔·네트워크 통합·개선
• rc.4: 콘솔 메시지 풍부한 표시(Runtime.consoleAPICalled), Zod external로 CI·번들 오류 수정

v0.1.0-rc.5

v0.1.0-rc.5

agent-browser 스타일 compact 출력 및 ref 기반 주소 체계를 도입한 릴리즈입니다.

설치

npm install -g @ohah/electron-mcp-server@0.1.0-rc.5
# 또는
npx -y @ohah/electron-mcp-server@0.1.0-rc.5

주요 변경 사항

🚀 토큰 절감 (compact 출력)

• 모든 주요 도구 응답을 JSON → compact 텍스트로 전환
• take_snapshot: raw JSON 대비 -97~99% 토큰 절감
• get_electron_process_structure: -74.2%
• get_electron_window_info: -60.7%
• select_port: -48.4%

🏷️ ref 기반 주소 체계

• [ref=e1] — 인터랙티브 요소 (click, fill 등에서 @e1로 참조)
• [ref=p1] — 프로세스 (select_page에서 참조)
• [ref=ch1] — IPC 채널 (get_electron_main_ipc_event에서 참조)

📸 take_snapshot 개선

• interactive 모드: 버튼·링크·입력만 표시 (최대 토큰 절감)
• compact 모드: 무명 structural 요소 제거
• maxDepth 옵션: 트리 깊이 제한
• ignored 노드 버그 수정 (rc4에서 전체 트리 누락되던 문제)

🔧 기타 개선

• 콘솔 deep resolve: 중첩 객체를 Runtime.callFunctionOn으로 완전 전개
• 네트워크 헤더 필터링: 디버깅에 유용한 헤더만 표시
• cross-port 타겟 탐색: main(9229) + renderer(9222) 분리 환경 지원
• 빌드: bunup → tsdown 전환 (출력 index.cjs)

요구 사항

• Node.js >=22 또는 Bun >=1.0.0
• Electron 앱은 --remote-debugging-port=9222 필요

v0.1.0-rc.4 대비

항목	rc.4	rc.5
출력 형식	JSON	compact 텍스트
요소 참조	uid (긴 문자열)	@e1 (짧은 ref)
snapshot 정확도	1개 노드 (ignored 버그)	전체 트리
snapshot 토큰	219,053 chars	2,193~6,265 chars
cross-port	미지원	지원
콘솔 중첩 객체	[Object]	완전 전개

v0.1.0-rc.3

v0.1.0-rc.3

메인 프로세스 IPC·네트워크 모니터 도구 추가 및 콘솔·네트워크 도구 개선이 포함된 릴리즈입니다.

설치

npm install -g @ohah/electron-mcp-server
# 또는
npx -y @ohah/electron-mcp-server

변경 사항

• 메인 프로세스 IPC·네트워크 모니터: Electron 메인 프로세스의 IPC 채널 목록·메시지 및 네트워크 요청 캡처 도구 추가
• 콘솔·네트워크 도구: 콘솔·네트워크 도구 통합 및 메인 프로세스 네트워크 캡처 동작 수정
• 메인 프로세스 모니터링: 두 군데 CDP 연결(렌더러·메인), 리소스 사용량, Profiler/HeapProfiler 지원
• Runtime.evaluate: 메인 프로세스 평가 시 includeCommandLineAPI 옵션 반영
• 콘솔 목록: Chrome DevTools MCP 스타일 한 줄 형식으로 변경
• 문서: MCP 도구·파라미터 설명 영어 통일, README에 Node·권장 포트 안내, README 정리·한글판·MIT 라이선스
• 기타: Copilot 리뷰 반영(메모리·동시성·URL 등)

요구 사항

• Node.js >=24 또는 Bun >=1.0.0
• Electron 앱은 --remote-debugging-port=9222 필요

v0.1.0-rc.2 대비

• rc.2: npx 의존성 오류 제거, 단일 번들·런타임 의존성 제거
• rc.3: 메인 프로세스 IPC/네트워크 모니터, 콘솔·네트워크 통합·개선, Profiler/HeapProfiler·리소스 도구, 문서 정리

v0.1.0-rc.2

v0.1.0-rc.2

npx 실행 시 발생하던 의존성 오류를 제거한 릴리즈입니다.

설치

npm install -g @ohah/electron-mcp-server
# 또는
npx -y @ohah/electron-mcp-server

변경 사항

• npx 실행 오류 수정: Cannot find module '.../ajv/dist/ajv.js' 등 의존성 해석 오류 제거
  • MCP SDK·ws·zod를 모두 단일 번들(dist/index.js)에 포함
  • 런타임 의존성 제거(dependencies 비움) — npx 설치 시 추가 패키지 설치 없이 실행
• 빌드: 번들 대상 패키지는 devDependencies에 두어 CI/로컬 빌드 시에만 설치, 결과물에는 모두 번들 포함
• 요구 사항: Node.js >=24 또는 Bun >=1.0.0. Electron 앱은 --remote-debugging-port=9222 필요

v0.1.0-rc.1 대비

• rc.1: npm 배포 파이프라인, 패키지 메타·워크플로 정리 (런타임에 SDK·ws 등 node_modules 의존)
• rc.2: 위 라이브러리를 번들에 포함해 런타임 의존성 제거, npx 사용 시 오류 해소

v0.1.0-rc.1

v0.1.0-rc.1

첫 번째 npm 배포용 릴리즈 후보입니다.

설치

npm install -g @ohah/electron-mcp-server
# 또는
npx -y @ohah/electron-mcp-server

요약

• MCP 서버: Electron 앱을 CDP(Chrome DevTools Protocol)로 제어하는 MCP 도구 제공
• 요구 사항: Electron 앱이 --remote-debugging-port=9222 로 실행 중이어야 함
• 엔진: Node.js >=24 또는 Bun >=1.0.0

변경 사항

• npm 패키지 메타(license, repository, homepage, bugs, author) 및 publishConfig 설정
• GitHub Actions: Release 발행 또는 수동 실행 시 Bun 빌드 후 npm publish (--provenance)
• 패키지 스크립트 Bun 통일, 빌드 실패 시 chmod-dist에서 명시적 실패 처리
• README: Cursor/Claude Desktop 등 MCP 클라이언트 안내 및 도구 요약