• 한국어

      • 시작하기

      5분 안에 프로젝트에 React Native MCP를 설정하세요.

      사전 요구 사항

      • React Native 0.72 이상
      • Node.js 18+ (또는 Bun)
      • idb (iOS 시뮬레이터) 또는 adb (Android) — 설치 및 연결 참고
      • MCP 클라이언트: Cursor, Claude Desktop, Claude Code, 또는 GitHub Copilot CLI

      Step 1: 설치 및 설정 (30초)

      프로젝트 루트에서 CLI init 명령어를 실행합니다:

      npx -y @ohah/react-native-mcp-server init

      프로젝트를 자동 감지(React Native 버전, Expo 여부, 패키지 매니저)하고:

      1. babel.config.js에 Babel 프리셋 추가
      2. MCP 클라이언트(Cursor, Claude 등) 설정 파일 생성
      3. .gitignore 업데이트

      이미 수동으로 설정하셨나요? 설치 및 연결과 CLI Init에서 자세한 내용을 확인하세요.

      Step 2: 앱 실행

      Bare RN
      Expo
      # Metro 시작
npx react-native start

# 다른 터미널에서 시뮬레이터/에뮬레이터 실행

npx react-native run-ios

# 또는

npx react-native run-android

      Android 에뮬레이터에서는 포트 포워딩을 설정하세요:

      adb reverse tcp:12300 tcp:12300

      Step 3: 연결 확인

      MCP 클라이언트를 열고 다음을 시도하세요:

      "앱 화면 스냅샷 찍어줘"

      AI가 컴포넌트 트리를 반환하면 연결이 정상입니다. 다음으로도 확인할 수 있습니다:

      "디버거 상태 확인해줘"

      이 명령은 get_debugger_status를 호출하며, appConnected: true와 디바이스 목록이 표시되어야 합니다.

      다음 단계