#CLI Init — 빠른 설정

한 줄 명령어로 React Native MCP를 프로젝트에 설정합니다.

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

수동 설정(babel config, 클라이언트 config, gitignore)을 대체하는 인터랙티브 셋업 위저드입니다.

#동작 과정

#단계별 상세

#Step 1 — 프로젝트 감지

프로젝트 디렉토리를 읽어 자동으로 감지합니다:

package.json에 react-native가 없으면 에러와 함께 종료됩니다.

#Step 1.5 — 외부 도구 확인

adb(Android)와 idb(iOS, macOS만)의 설치 여부를 자동으로 확인합니다.

설치되어 있지 않으면 경고와 설치 안내를 표시하지만, 셋업은 계속 진행됩니다. 상세 안내는 설치 및 연결 — 네이티브 도구를 참고하세요.

#Step 2 — MCP 클라이언트 선택

사용하는 MCP 클라이언트를 선택합니다. 설정 파일 생성 위치가 결정됩니다.

생성되는 설정 내용:

{
  "mcpServers": {
    "react-native-mcp": {
      "command": "npx",
      "args": ["-y", "@ohah/react-native-mcp-server"]
    }
  }
}

파일이 이미 있으면 react-native-mcp 항목만 병합합니다. 기존 설정은 유지됩니다.

#Step 3 — 변경 적용

다음이 적용됩니다:

1. package.json — 앱 패키지의 devDependencies에 @ohah/react-native-mcp-server 추가(이미 있으면 스킵). 이어서 패키지 매니저 install 실행(--no-install 시 생략).
2. babel.config.js — presets 배열에 @ohah/react-native-mcp-server/babel-preset 추가.
3. MCP 클라이언트 설정 — 위에서 설명한 경로에 생성/병합.
4. .gitignore — /results/ 추가 (E2E 테스트 출력 디렉토리).

각 단계는 멱등성을 보장합니다. 다시 실행하면 이미 적용된 변경은 건너뜁니다.

#Step 4 — 다음 단계 안내

프로젝트 타입에 따라 다음 할 일을 안내합니다:

• Expo: npx expo start
• Bare RN: REACT_NATIVE_MCP_ENABLED=true npx react-native start

#옵션

# CI / 자동화
npx -y @ohah/react-native-mcp-server init --client cursor -y

# 특정 클라이언트 지정
npx -y @ohah/react-native-mcp-server init --client antigravity

#package.json 추가 및 install

init은 앱 패키지의 package.json에 @ohah/react-native-mcp-server를 devDependencies로 추가합니다. 이미 있으면 건너뜁니다. 이어서 패키지 매니저 install을 실행해 의존성을 설치합니다(생략하려면 --no-install).

• 단일 레포: 앱 루트의 package.json에 추가 후, 앱 루트에서 install 실행.
• 모노레포: 선택한 앱 패키지의 package.json에 추가 후, 모노레포 루트에서 install 실행(워크스페이스 전체 갱신).

init이 자동으로 앱 package.json에 추가하므로, 모노레포에서도 수동으로 의존성을 넣을 필요 없이 루트에서 init만 실행하면 됩니다.

# 루트에서
npx -y @ohah/react-native-mcp-server init -y
# 또는 앱 경로 지정
npx -y @ohah/react-native-mcp-server init -y --app apps/mobile

#멱등성

init을 여러 번 실행해도 안전합니다: