MCP iOS 시뮬레이터 스크린샷

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

개요

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

설정

클라인과 루 코드

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 명령을 직접 실행할 수 있는지 확인하세요.
권한 오류가 발생하는 경우 :
- 출력 디렉토리에 대한 쓰기 권한이 있는지 확인하세요

요구 사항

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

기술 스택

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

특허

MIT

다른 언어들

일본어

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

get_ios_simulator_screenshot

MCP(Model Context Protocol)를 사용하여 iOS 시뮬레이터의 스크린샷을 캡처하고 지정된 디렉토리에 저장하는 서버입니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

simulator-mcp-server
JoshuaRileyDev
-
security
F
license
-
quality
An MCP server to control iOS Simulators.
Last updated -
41
22
JavaScript
MCP-URL2SNAP
Abhi5h3k
-
security
F
license
-
quality
A lightweight Model Context Protocol (MCP) server that enables your LLM to capture screenshots of any specified URL and return only the access URL for the captured image. This tool simplifies the process of generating and sharing webpage snapshots, making it perfect for integrating visual capture ca
Last updated -
1
Python
webdev-mcp
zueai
-
security
-
license
-
quality
An MCP server that provides web development tools including taking screenshots of screens, enabling AI agents to capture and analyze visual content during development.
Last updated -
2
TypeScript
webdev-mcp
fefergrgrgrg
A
security
F
license
A
quality
An MCP server providing web development tools such as screen capturing capabilities that let AI agents take and work with screenshots of the user's screen.
Last updated -
2
27
2
TypeScript

View all related MCP servers

MCP iOS Simulator Screenshot