• 한국어

      • 도구 레퍼런스

      React Native MCP는 12개 카테고리에 걸쳐 42개의 도구를 제공합니다. 모든 도구는 MCP 호환 클라이언트(Cursor, Claude, Copilot 등)에서 별도 설정 없이 바로 사용할 수 있습니다.

      공통 파라미터

      대부분의 도구는 다음과 같은 선택적 파라미터를 지원합니다:

      파라미터타입설명
      deviceIdstring대상 디바이스 ID. 연결된 디바이스가 하나뿐이면 생략 가능하며, 자동으로 선택됩니다. get_debugger_status로 연결된 디바이스 목록을 확인할 수 있습니다.
      platform"ios" | "android"대상 플랫폼. 해당 플랫폼의 디바이스가 하나만 연결되어 있으면 자동으로 감지됩니다.

      셀렉터 문법

      여러 도구에서 React Native Fiber 트리를 조회하는 selector 파라미터를 지원합니다. 지원하는 문법은 다음과 같습니다:

      패턴예시설명
      타입Text컴포넌트 타입으로 매칭
      testID#submit-btntestID prop으로 매칭
      텍스트:text("Hello")텍스트 내용으로 매칭
      속성[accessibilityLabel="Close"]prop 값으로 매칭
      displayName:display-name("MyComponent")display name으로 매칭
      인덱스:nth-of-type(2)해당 타입의 N번째 요소 매칭
      기능:has-press터치 가능한 요소
      계층 구조ScrollView > View > Text직계 자식 또는 하위 요소
      OR#btn-a, #btn-b둘 중 하나의 셀렉터와 매칭

      각 도구 페이지에서 상세한 파라미터 표, 예시, 플랫폼별 팁을 확인할 수 있습니다.

      카테고리

      카테고리도구 수설명
      디바이스 및 상태5연결 상태, 디바이스 목록, 딥링크, GPS, 앱 초기화
      화면 캡처4스크린샷, 컴포넌트 트리 스냅샷, 네이티브 UI 트리, 비주얼 비교
      요소 조회4요소 검색, 앱 또는 WebView에서 JS 실행
      인터랙션8탭, 스와이프, 텍스트 입력, 키 이벤트, 스크롤
      어설션4텍스트, 가시성, 요소 개수 검증
      콘솔 및 네트워크4콘솔 로그 및 네트워크 요청 검사
      네트워크 모킹4백엔드 변경 없이 API 응답 모킹
      상태 검사3React 훅 및 상태 변경 검사
      렌더 프로파일링3렌더 프로파일링, 불필요한 리렌더 탐지
      접근성1자동화된 접근성 감사
      파일 및 미디어2파일 전송, 사진/동영상을 갤러리에 추가