Skip to main content
Glama
deenesjakoruzh
yorifuji

MCP iOS Simulator Screenshot

by yorifuji
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

MCP iOS 시뮬레이터 스크린샷

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

개요

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

Related MCP server: Screeny MCP Server

설정

클라인과 루 코드

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

다른 언어들

Available Tools

1 tool
get_screenshotC

Capture a screenshot from iOS Simulator

ParametersJSON Schema
NameRequiredDescriptionDefault
output_filenameNoOutput filename (if not specified, timestamp.png will be used)
output_directory_nameNoSubdirectory name for screenshots (if not specified, .screenshots will be used).screenshots
resizeNoWhether to resize the image to approximately VGA size
max_widthNoMaximum width for resizing (pixels)
device_idNoSpecify a simulator device (if not specified, the booted device will be used)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. 'Capture a screenshot' implies a read operation, but it doesn't specify whether this requires specific simulator states, permissions, or has side effects. The description lacks information about error conditions, what happens if no device is booted, or the format/location of output beyond what's in parameter descriptions.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence that states the core purpose without unnecessary words. It's appropriately sized for a straightforward tool and gets directly to the point. Every word earns its place in conveying the essential function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no annotations and no output schema, the description is insufficiently complete. While the purpose is clear, it lacks important behavioral context about how the tool operates, what it returns, error handling, and dependencies. The description doesn't compensate for the absence of structured metadata that would help an agent understand the tool's behavior and constraints.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 100% schema description coverage, all parameters are well-documented in the schema itself. The description adds no additional parameter information beyond what's already in the schema descriptions. This meets the baseline expectation when schema coverage is complete, but doesn't provide extra semantic context.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Capture') and target resource ('screenshot from iOS Simulator'), making the purpose immediately understandable. It lacks sibling differentiation, but since there are no sibling tools, this doesn't reduce clarity. The description is specific enough to distinguish this from other potential screenshot tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, prerequisites, or context. It simply states what the tool does without indicating appropriate scenarios or limitations. While there are no sibling tools to differentiate from, the description offers no usage context whatsoever.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool update
    • First observedget_screenshot
Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is singular and clearly defined, making it impossible for an agent to misselect between non-existent alternatives.

Naming Consistency5/5

A single tool inherently has perfect naming consistency, as there are no other tools to compare against. The tool name 'get_screenshot' follows a clear verb_noun pattern, which would be consistent if more tools existed.

Tool Count2/5

A single tool is too few for most practical server purposes, as it severely limits functionality and flexibility. While the server's name suggests a focused domain (iOS Simulator screenshots), one tool feels thin and incomplete for even basic operations like listing simulators or managing screenshots.

Completeness2/5

The tool surface is severely incomplete for the implied domain of iOS Simulator interactions. It only provides screenshot capture, with obvious gaps such as listing available simulators, starting/stopping simulators, or managing screenshot files, which are essential for a coherent workflow.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

Appeared in Searches