#Device & Status

연결 상태 확인, 디바이스 목록 조회, 딥링크 네비게이션, GPS 설정, 앱 상태 초기화를 위한 도구입니다.

#get_debugger_status

MCP 연결 상태를 확인하고 연결된 디바이스 목록을 조회합니다. 다른 도구를 사용하기 전에 이 도구를 먼저 호출하여 설정을 확인하세요.

#Parameters

#Example

// Request
{ "tool": "get_debugger_status" }

// Response
{
  "appConnected": true,
  "devices": [
    { "deviceId": "emulator-5554", "platform": "android" }
  ]
}

#Tips

• 다른 도구를 사용하기 전에 항상 이 도구를 먼저 호출하여 앱이 연결되어 있는지 확인하세요.
• Android에서 상태 바 오프셋이 올바르지 않은 경우(예: 노치 디바이스) topInsetDp를 사용하세요.

#list_devices

연결된 시뮬레이터/에뮬레이터 및 실제 디바이스 목록을 조회합니다.

#Parameters

#Example

// Request
{ "tool": "list_devices", "arguments": { "platform": "android" } }

// Response
[
  { "deviceId": "emulator-5554", "state": "device", "model": "Pixel_7_API_34" }
]

#Tips

• iOS는 idb가 설치되어 있어야 합니다.
• Android는 PATH에 adb가 포함되어 있어야 합니다.

#open_deeplink

시뮬레이터/디바이스에서 딥링크 URL을 열어 특정 화면으로 직접 이동합니다.

#Parameters

#Example

// Request
{
  "tool": "open_deeplink",
  "arguments": {
    "platform": "ios",
    "url": "myapp://settings/profile"
  }
}

#Tips

• 앱의 네이티브 설정에 URL 스킴이 등록되어 있는지 확인하세요.
• iOS: xcrun simctl openurl을 사용합니다. Android: adb shell am start를 사용합니다.

#set_location

iOS 시뮬레이터 또는 Android 에뮬레이터에서 GPS 좌표를 설정합니다.

#Parameters

#Example

// Request
{
  "tool": "set_location",
  "arguments": {
    "platform": "android",
    "latitude": 37.5665,
    "longitude": 126.978
  }
}

#Tips

• Android: 에뮬레이터(AVD)에서만 동작하며, 실제 디바이스에서는 사용할 수 없습니다.
• iOS: xcrun simctl location set을 사용합니다.

#clear_state

앱 데이터를 삭제하거나 권한을 초기화합니다.

#Parameters

#Example

// Request
{
  "tool": "clear_state",
  "arguments": {
    "platform": "android",
    "appId": "com.myapp"
  }
}

#Tips

• Android: pm clear를 실행하여 모든 앱 데이터(스토리지, 데이터베이스, 환경설정)를 삭제합니다.
• iOS: 개인정보 권한만 초기화합니다(xcrun simctl privacy reset). iOS에서 전체 데이터를 초기화하려면 앱을 삭제 후 재설치해야 합니다.