MCP iOS 시뮬레이터 스크린샷

MCP(Model Context Protocol)를 사용하여 iOS 시뮬레이터에서 스크린샷을 캡처하는 서버입니다.

개요

이 프로젝트는 iOS 시뮬레이터의 현재 화면을 캡처하여 지정된 디렉토리에 저장하는 MCP 프로토콜 서버를 구현합니다.

Related MCP server: MCP-URL2SNAP

설정

클라인과 루 코드

Cline과 Roo 코드의 기본 형식은 다음과 같습니다.

지엑스피1

저장소를 복제하면 다음 구성을 사용할 수 있습니다.

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "node",
      "args": ["/path/to/mcp-ios-simulator-screenshot/build/index.js"]
    }
  }
}

커서, 클로드 데스크탑

Cursor와 Claude Desktop의 경우 --output-dir 과 출력 디렉토리를 지정해야 합니다.

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "npx",
      "args": [
        "mcp-ios-simulator-screenshot",
        "--output-dir",
        "/path/to/your/output/directory"
      ]
    }
  }
}

MCP 도구 매개변수

스크린샷 받기

iOS 시뮬레이터에서 스크린샷을 캡처하여 지정된 디렉토리에 저장합니다.

매개변수	유형	설명	기본값
출력_파일 이름	끈	출력 파일 이름	타임스탬프.png
출력_디렉토리_이름	끈	스크린샷의 하위 디렉토리 이름	.스크린샷
크기 조정	부울	이미지 크기를 대략 VGA 크기로 조정할지 여부	진실
최대 너비	정수	크기 조정을 위한 최대 너비(픽셀)	640
장치_아이디	끈	시뮬레이터 장치를 지정하세요	부팅된 장치

출력 형식

성공 시:

{
  "success": true,
  "message": "iOS Simulator screenshot saved successfully",
  "filePath": ".screenshots/simulator_2025-04-10T16-51-16-755Z.png",
  "metadata": {
    "width": 1170,
    "height": 2532,
    "format": "png",
    "size": 382946,
    "timestamp": "2025-04-10T16:51:16.755Z"
  },
  "serverConfig": {
    "commandLineArgs": {
      "outputDir": "/Users/username/Desktop" // Only included when --output-dir is specified
    }
  }
}

참고: serverConfig.commandLineArgs.outputDir 필드는 서버를 시작할 때 --output-dir 매개변수가 지정된 경우에만 응답에 포함됩니다.

{
  "success": false,
  "message": "Error capturing iOS Simulator screenshot: [error message]",
  "error": {
    "code": "ENOENT",
    "command": "xcrun simctl io booted screenshot --type=png -",
    "stderr": "No matching devices found."
  }
}

문제 해결

스크린샷을 캡처할 수 없는 경우 :
- iOS 시뮬레이터가 실행 중인지 확인하세요
- Xcode 명령줄 도구가 설치되어 있는지 확인하세요
- xcrun simctl io booted screenshot 명령을 직접 실행할 수 있는지 확인하세요.
권한 오류가 발생하는 경우 :
- 출력 디렉토리에 대한 쓰기 권한이 있는지 확인하세요