iOS 시뮬레이터 MCP 서버

iOS 시뮬레이터와 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 사용하면 iOS 시뮬레이터에 대한 정보를 얻고, UI 상호작용을 제어하고, UI 요소를 검사하여 시뮬레이터와 상호작용할 수 있습니다.

https://github.com/user-attachments/assets/453ebe7b-cc93-4ac2-b08d-0f8ac8339ad3

특징

• 현재 부팅된 iOS 시뮬레이터의 ID를 가져옵니다.
• 시뮬레이터 UI와 상호 작용:
  • 화면의 모든 접근성 요소를 설명하세요
  • 화면 좌표를 탭하세요
  • 입력 텍스트
  • 좌표 사이를 스와이프하세요
  • 특정 좌표의 UI 요소에 대한 정보 가져오기
  • 시뮬레이터 화면의 스크린샷을 찍으세요
• 환경 변수를 사용하여 특정 도구 필터링

구성

환경 변수

• IOS_SIMULATOR_MCP_FILTERED_TOOLS : 등록에서 제외할 도구 이름을 쉼표로 구분하여 나열합니다. 예: screenshot,record_video,stop_recording

💡 사용 사례: 에이전트 모드의 QA 단계

이 MCP는 기능을 구현한 직후 품질 보증 단계로 에이전트 모드에서 효과적으로 사용하여 UI 일관성과 올바른 동작을 보장할 수 있습니다.

사용 방법

기능 구현 후:

1. 커서에서 에이전트 모드를 활성화합니다.
2. 아래 프롬프트를 사용하여 UI 상호작용을 빠르게 검증하고 문서화하세요.

예시 프롬프트

• UI 요소 확인:지엑스피1
• 텍스트 입력 확인:
  Enter "QA Test" into the text input field and confirm the input is correct
• 탭 응답 확인:
  Tap on coordinates x=250, y=400 and verify the expected element is triggered
• 스와이프 동작 검증:
  Swipe from x=150, y=600 to x=150, y=100 and confirm correct behavior
• 자세한 요소 확인:
  Describe the UI element at position x=300, y=350 to ensure proper labeling and functionality
• 스크린샷 찍기:
  Take a screenshot of the current simulator screen and save it to my_screenshot.png
• 비디오 녹화:
  Start recording a video of the simulator screen (saves to ~/Downloads/simulator_recording_$DATE.mp4 by default)
• 녹음 중지:
  Stop the current simulator screen recording

필수 조건

• 노드.js
• macOS(iOS 시뮬레이터는 macOS에서만 사용 가능)
• Xcode 및 iOS 시뮬레이터 설치됨
• Facebook IDB 도구 (설치 가이드 참조)

설치

옵션 1: NPX 사용(권장)

1. 커서 MCP 구성을 편집하세요.
   cursor ~/.cursor/mcp.json
2. 구성에 iOS 시뮬레이터 서버를 추가합니다.
   { "mcpServers": { "ios-simulator": { "command": "npx", "args": ["-y", "ios-simulator-mcp"] } } }
3. 커서를 다시 시작합니다.

옵션 2: 지역 개발

1. 이 저장소를 복제하세요:
   git clone https://github.com/joshuayoes/ios-simulator-mcp cd ios-simulator-mcp
2. 종속성 설치:
   npm install
3. 프로젝트를 빌드하세요:
   npm run build
4. 커서 MCP 구성을 편집하세요.
   cursor ~/.cursor/mcp.json
5. 구성에 iOS 시뮬레이터 서버를 추가합니다.
   { "mcpServers": { "ios-simulator": { "command": "node", "args": ["/path/to/your/ios-simulator-mcp/build/index.js"] } } }
   "/path/to/your" 프로젝트 디렉토리의 실제 경로로 바꾸세요.
6. 커서를 다시 시작합니다.

특허

MIT