
Baepsae
If you're testing iOS apps in the simulator or automating macOS UI interactions, this gives Claude direct access to xcrun simctl commands plus a Swift native bridge for accessibility APIs. It exposes tools for launching simulators, installing apps, taking screenshots, and running UI automation actions like tap, type, and element inspection. The Swift layer handles the AppKit and CoreGraphics calls that Node can't touch directly. Requires macOS 14+, Xcode tooling, and accessibility permissions granted to whatever process launches the server, not the target app. The installer script handles registration across Claude Code, Codex, Gemini, and other MCP clients with npx or local build options.
- GitHub stars
- 24
- tools
- 47
- transport
- STDIO
- last updated
- Mar 31, 2026
Tools
47 toolsPublic tool metadata for what this MCP can expose to an agent.
analyze_uiInspect the accessibility tree of the target app.
Inspect the accessibility tree of the target app.
No parameter schema in public metadata yet.
query_uiSearch the accessibility tree for matching elements.
Search the accessibility tree for matching elements.
No parameter schema in public metadata yet.
tapTap an accessibility element selected by identifier or label.
Tap an accessibility element selected by identifier or label.
No parameter schema in public metadata yet.
tap_tabSwitch tabs by index using a semantic-first, geometry-last strategy.
Switch tabs by index using a semantic-first, geometry-last strategy.
No parameter schema in public metadata yet.
type_textType text into the target, accepting exactly one input source (text, stdinText, or file).
Type text into the target, accepting exactly one input source (text, stdinText, or file).
No parameter schema in public metadata yet.
swipe
No parameter schema in public metadata yet.
scroll
No parameter schema in public metadata yet.
drag_drop
No parameter schema in public metadata yet.
wait_for_ui
No parameter schema in public metadata yet.
detect_dialog
No parameter schema in public metadata yet.
read_ui_value
No parameter schema in public metadata yet.
set_ui_value
No parameter schema in public metadata yet.
read_ui_param
No parameter schema in public metadata yet.
hit_test
No parameter schema in public metadata yet.
enumerate_ui
No parameter schema in public metadata yet.
key
No parameter schema in public metadata yet.
key_sequence
No parameter schema in public metadata yet.
key_combo
No parameter schema in public metadata yet.
touch
No parameter schema in public metadata yet.
input_source
No parameter schema in public metadata yet.
list_input_sources
No parameter schema in public metadata yet.
run_steps
No parameter schema in public metadata yet.
list_windows
No parameter schema in public metadata yet.
activate_app
No parameter schema in public metadata yet.
screenshot_appTake a screenshot of a macOS app.
Take a screenshot of a macOS app.
No parameter schema in public metadata yet.
right_click
No parameter schema in public metadata yet.
focus_window
No parameter schema in public metadata yet.
context_menu_action
No parameter schema in public metadata yet.
watch_notification
No parameter schema in public metadata yet.
list_simulators
No parameter schema in public metadata yet.
screenshot
No parameter schema in public metadata yet.
record_video
No parameter schema in public metadata yet.
stream_video
No parameter schema in public metadata yet.
open_urlOpen a URL in the iOS Simulator.
Open a URL in the iOS Simulator.
No parameter schema in public metadata yet.
install_appInstall an app in the iOS Simulator.
Install an app in the iOS Simulator.
No parameter schema in public metadata yet.
launch_appLaunch an app in the iOS Simulator.
Launch an app in the iOS Simulator.
No parameter schema in public metadata yet.
terminate_appTerminate an app in the iOS Simulator.
Terminate an app in the iOS Simulator.
No parameter schema in public metadata yet.
uninstall_app
No parameter schema in public metadata yet.
button
No parameter schema in public metadata yet.
gesture
No parameter schema in public metadata yet.
list_appsList running macOS apps.
List running macOS apps.
No parameter schema in public metadata yet.
menu_action
No parameter schema in public metadata yet.
get_focused_app
No parameter schema in public metadata yet.
clipboard
No parameter schema in public metadata yet.
baepsae_help
No parameter schema in public metadata yet.
baepsae_version
No parameter schema in public metadata yet.
doctor
No parameter schema in public metadata yet.
Sponsors
Readme
mcp-baepsae
baepsae
Baepsae (Vinous-throated Parrotbill) — A tiny Korean bird. Round, chubby, and constantly hopping around chirping. Known for its grit — even when a little bird tries to keep up with a stork, it never gives up. This project is small too, but it pecks away at your simulators tirelessly.
Local MCP server for iOS Simulator and macOS app automation with a TypeScript MCP layer and a Swift native bridge.
한국어 문서는 README-KR.md를 참고하세요.
Table of Contents
- Prerequisites
- Platform Support
- Install
- Permissions
- MCP Setup (Recommended)
- Client Matrix
- For LLM
- Manual Setup (Fallback)
- Project Structure
- Commands
- MCP Tool Status
- Usage Examples
- Troubleshooting
Prerequisites
- macOS 14+
- Xcode + iOS Simulator
- Node.js 18+
- Swift 6+
Platform Support
Details
- Repository
- github.com/oozoofrog/mcp-baepsae
- Categories
- Automation & Workflows, Mobile Development
- Package
mcp-baepsae- Transport
- STDIO
- Registry
- MCP registry, active