iOS Simulator MCP

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

💡 사용 사례: MCP 도구 호출을 통한 QA 단계

이 MCP 서버는 모델 컨텍스트 프로토콜(MCP) 클라이언트와 통합된 AI 어시스턴트가 도구 호출을 통해 품질 보증 작업을 수행할 수 있도록 합니다. 이는 기능 구현 직후 UI 일관성과 올바른 동작을 보장하는 데 유용합니다.

사용 방법

기능 구현 후, MCP 클라이언트 환경에서 AI 어시스턴트에게 사용 가능한 도구를 사용하도록 지시하세요. 예를 들어, 커서의 에이전트 모드에서 아래 프롬프트를 사용하여 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 도구 (설치 가이드 참조)

설치

이 섹션에서는 iOS 시뮬레이터 MCP 서버를 다양한 MCP(Model Context Protocol) 클라이언트와 통합하는 방법에 대한 지침을 제공합니다.

커서를 사용한 설치

커서는 ~/.cursor/mcp.json 에 있는 구성 파일을 통해 MCP 서버를 관리합니다.

옵션 1: NPX 사용(권장)

1. Cursor MCP 구성 파일을 편집하세요. Cursor에서 직접 열거나 다음과 같은 명령을 사용할 수 있습니다.
   # Open with your default editor (or use 'code', 'vim', etc.) open ~/.cursor/mcp.json # Or use Cursor's command if available # cursor ~/.cursor/mcp.json
2. iOS 시뮬레이터 서버 구성으로 mcpServers 섹션을 추가하거나 업데이트합니다.
   { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "npx", "args": ["-y", "ios-simulator-mcp"] } } }
   특히 mcpServers 이미 있는 경우 JSON 구조가 유효한지 확인하세요.
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 구성 파일을 편집합니다(옵션 1에 표시된 대로).
5. 로컬 빌드를 가리키도록 mcpServers 섹션을 추가하거나 업데이트합니다.
   { "mcpServers": { // ... other servers might be listed here ... "ios-simulator": { "command": "node", "args": ["/full/path/to/your/ios-simulator-mcp/build/index.js"] } } }
   중요: /full/path/to/your/``ios-simulator-mcp 저장소를 복제한 절대 경로로 바꾸세요.
6. 변경 사항을 적용하려면 커서를 다시 시작하세요.

Claude Code를 사용한 설치

Claude Code CLI는 claude mcp 명령을 사용하거나 구성 파일을 직접 편집하여 MCP 서버를 관리할 수 있습니다. Claude Code MCP 구성에 대한 자세한 내용은 공식 문서 를 참조하세요.

옵션 1: NPX 사용(권장)

1. claude mcp add 명령을 사용하여 서버를 추가합니다.
   claude mcp add ios-simulator --command npx --args "-y,ios-simulator-mcp"
   참고: --args 매개변수는 쉼표로 구분된 단일 문자열을 사용합니다.
2. 필요한 경우 실행 중인 Claude Code 세션을 다시 시작하세요.

옵션 2: 지역 개발

1. 이 저장소를 복제하고 종속성을 설치한 다음, 커서 "로컬 개발" 1~3단계에 설명된 대로 프로젝트를 빌드합니다.
2. 로컬 빌드를 가리키고 claude mcp add 명령을 사용하여 서버를 추가합니다.
   claude mcp add ios-simulator --command node --args "/full/path/to/your/ios-simulator-mcp/build/index.js"
   중요: /full/path/to/your/``ios-simulator-mcp 저장소를 복제한 절대 경로로 바꾸세요.
3. 필요한 경우 실행 중인 Claude Code 세션을 다시 시작하세요.

특허

MIT