MCP iOS 시뮬레이터 스크린샷

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

개요

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

설정

설치 :

지엑스피1

MCP 클라이언트 구성 :

다음과 같이 MCP 클라이언트 구성 파일에 서버 정보를 추가합니다.

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "mcp-ios-simulator-screenshot"
    }
  }
}

환경 변수

이 서버는 환경 변수를 사용하지 않습니다.

명령줄 인수

이 서버는 명령줄 인수를 사용하지 않습니다.

고급 구성

설치 방법에 따른 MCP 클라이언트 구성

글로벌하게 설치 시

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "mcp-ios-simulator-screenshot"
    }
  }
}

로컬로 설치 시

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

저장소에서 복제할 때

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

npx를 사용할 때

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "npx",
      "args": ["mcp-ios-simulator-screenshot"]
    }
  }
}

Docker를 사용할 때

{
  "mcpServers": {
    "mcp-ios-simulator-screenshot": {
      "command": "docker",
      "args": ["run", "-i", "mcp-ios-simulator-screenshot"]
    }
  }
}

문제 해결

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

프로젝트 구조

./
├── src/
│   ├── index.ts                  # Entry point
│   ├── config.ts                 # Configuration
│   ├── types.ts                  # Type definitions
│   └── services/
│       └── screenshot-service.ts # Screenshot service
├── build/                        # Build output
├── .screenshots/                 # Default output directory
└── package.json                  # Project configuration

도구

get_ios_simulator_screenshot

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

매개변수

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

출력 형식

성공 시:

{
  "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"
  }
}

오류 발생 시:

{
  "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."
  }
}

요구 사항

Node.js 16.0.0 이상
macOS(iOS 시뮬레이터 필요)
Xcode 명령줄 도구

기술 스택

타입스크립트
노드.js
MCP SDK (@modelcontextprotocol/sdk)

특허

MIT

다른 언어들

일본어

MCP iOS Simulator Screenshot

Integrations