iOS Simulator 제어를 위한 MCP Server

YouTube에서 전체 영상을 시청하세요

AI 어시스턴트가 iOS Simulator를 제어할 수 있게 해주는 MCP (Model Context Protocol) 서버입니다. Claude Desktop, Cursor, Claude Code 및 기타 MCP 호환 클라이언트와 원활하게 통합됩니다.

이 프로젝트가 유용하다고 생각되시면 ⭐️를 눌러주세요.

Brew:

brew tap AppGram/tap
brew install bridge4simulator
bridge4simulator --version

Installer:

curl -fsSL https://github.com/AppGram/bridge4simulator/releases/latest/download/install.sh | bash

내부적으로 MCP는 자체 제작된 브릿지(bridge)에 의존합니다. 이 CLI를 구동하는 도구의 상업적 이용에 관한 문의는 언제든 저희에게 연락해 주세요.

터미널에서 첫 실행:
bridge4simulator mcp --http

Settings > MCP로 이동하여 다음을 추가하세요:

그 다음 설정을 추가합니다.

"bridge4simulator": {
"url": "http://localhost:8080/mcp"
},

또는 Claude Desktop 설정에서:

{
"mcpServers": {
"bridge4simulator": {
...

Claude Desktop은 로컬 개발용 MCP에 대한 url을 지원하지 않습니다.

~/.claude/settings.json 또는 프로젝트 .mcp.json에 추가하세요:

{
"mcpServers": {
"ios-simulator": {
...

이 데모는 자율 주행(autonomous navigation)과 작업 실행 뒤에 숨겨진 내부 추론 과정을 강조합니다. 내부적으로 MCP는 즉각적인 OCR 및 UI 추출을 가능하게 하면서도, 빠른 문제 해결을 위해 토큰 소비를 최소화하는 강력한 CLI 도구를 사용합니다.

Apple Calendar 데모	Apple Maps 데모
[IMG:1]	[IMG:2]

카테고리	도구 (Tools)	설명
Device (장치)	device_list , device_boot , device_shutdown , status	시뮬레이터 장치 관리
Input (입력)	tap , swipe , type_text	터치 제스처 및 텍text 입력
Capture (캡처)	screenshot , record_start , record_stop	화면 캡처 및 녹화
Apps (앱)	app_install , app_launch , app_terminate	애플리케이션 라이프사이클 (Lifecycle)
Navigation (탐색)	open_url	URL 및 딥 링크 (Deep links) 열기
UI	ui_describe , ui_find , ui_search , ui_summary , ui_point , ui_ocr	접근성 트리 (Accessibility tree) 및 OCR
Macros (매크로)	macro_play , macro_list	자동화 시퀀스 (Automation sequences)

설정이 완료되면, AI 어시스턴트에게 다음과 같이 요청해 보세요:

UI 상호작용 (UI Interaction):

"실행 중인 앱 내에서 로마와 피렌체 사이의 기차 경로를 찾아줘"

스크린샷 및 분석 (Screenshot & Analysis):

"iOS Simulator의 스크린샷을 찍고 화면에 무엇이 있는지 설명해줘"

탐색 (Navigation):

"리스트를 아래로 스크롤해서 설정 옵션을 찾아줘"

앱 테스트 (App Testing):

"com.example.myapp 앱을 실행하고 스크린샷을 찍어줘"

Xcode Command Line Tools
iOS Simulator (Xcode를 통해)

플랫폼	다운로드
Apple Silicon (M1/M2/M3/M4/M5)	bridge4simulator-darwin-arm64.tar.gz
Intel Macs	bridge4simulator-darwin-amd64.tar.gz

# MCP 서버 시작 (stdio를 통한 JSON-RPC)
bridge4simulator mcp

서버는 stdin으로부터 JSON-RPC 2.0 요청을 읽고 stdout으로 응답을 작성합니다.

문서 (Documentation): GitHub
이슈 (Issues): GitHub Issues
이메일 (Email): support@appgram.dev

Version 1.0.0 | AppGram