Baepsae

Name: Baepsae
Author: oozoofrog

von oozoofrogVersion 6.3.0i★ –iLäuft auf deinem Computer

Name in der Registryio.github.oozoofrog/baepsae

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Local MCP server for iOS Simulator and macOS app automation with a native Swift bridge

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Die Registry nennt keinen Schlüssel zum Eintragen.

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "baepsae": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-baepsae"
      ]
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add baepsae -- npx -y mcp-baepsae

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "baepsae": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-baepsae"
      ]
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "baepsae": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-baepsae"
      ]
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 6. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto oozoofrog bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32505 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 5 % der anderen 32505 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32505 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Baepsae sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (6.3.0) kam vor 7 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, topo^alpin

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert gestern

Installieren

topo^alpin

von topoalpin.app

Avalanche bulletins and mountain weather forecasts for any place in the Alps.

Läuft in der CloudAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

mcp-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를 참고하세요.

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

Platform	Supported	Notes
macOS	Yes	Primary platform. Required for iOS Simulator and Accessibility APIs.
Linux	No	Native binary depends on AppKit, CoreGraphics, and Accessibility frameworks.
Windows	No	Native binary depends on AppKit, CoreGraphics, and Accessibility frameworks.

Why macOS only?

The Swift native bridge (baepsae-native) uses macOS-specific frameworks (AppKit, CoreGraphics, Accessibility) to interact with iOS Simulator and macOS applications. These frameworks are not available on Linux or Windows. The TypeScript MCP layer also relies on xcrun simctl, which is part of Xcode Command Line Tools and only available on macOS.

Requirements summary:

macOS 14 or later -- required for iOS Simulator automation and Accessibility API access.
Xcode or Xcode Command Line Tools -- required for Swift 6+ compilation of the native binary and xcrun simctl commands.
Node.js >= 18.0.0 -- required to run the TypeScript MCP server.

Permissions

Accessibility permission is required for UI inspection and input automation features (use unified generic tools such as analyze_ui, tap, right_click).

The important detail is that permission usually needs to be granted to the automation host / runtime process, not to the target app you are automating.

Which process usually needs permission?

Direct native binary invocation
Example: baepsae-native ...
Most relevant entry: the baepsae-native binary itself, plus the terminal/shell app that launched it
Node / npx MCP runtime
Example: node dist/index.js, npx -y mcp-baepsae@latest
Most relevant entry: the runtime process (node), plus the terminal or MCP client app that launched it
Desktop / CLI MCP clients
Example: Claude Code, Codex CLI/Desktop, Gemini CLI
Relevant entries can include the MCP client app, the terminal host, and the runtime process depending on launch path

Recommended setup flow

Open System Settings > Privacy & Security > Accessibility.
Enable the terminal or MCP client app you actually use.
Enable the runtime process if listed (node, bun, etc.).
For direct native invocation, also enable the baepsae-native binary entry if it appears separately.
If an entry is missing, click + and add it manually.

Important note

After granting permission, the launching process may need to be restarted before macOS applies the change. If the error persists, quit and relaunch the terminal, MCP client, or runtime process that started mcp-baepsae.

For simulator targets, selector-based actions (tap / right_click with id or label) search in-app content by default. Set all: true to include Simulator chrome UI.

Install

Option A) npm (easiest)

# Run directly without installing

npx mcp-baepsae@latest

Or install globally

npm install -g mcp-baepsae

On macOS, the Swift native binary is built automatically during install. If Swift is not available, the server still works with simctl-based features.

If you plan to use UI inspection or input automation right away, grant Accessibility permission to the terminal / MCP client / runtime process you will actually launch the server with.

Option B) From source

git clone https://github.com/oozoofrog/mcp-baepsae.git

cd mcp-baepsae npm install npm run build

MCP Setup (Recommended)

Use the installer script that calls each client's MCP install flow directly.

bash scripts/install.sh --tool all

Client Matrix

Client	Install Path	Script Target	Notes
Claude Code	`claude mcp add`	`--tool claude-code`	Supports multi-scope via `--claude-scope`
Claude Desktop	`claude mcp add --scope user`	`--tool claude-desktop`	User-level registration
Codex CLI	`codex mcp add`	`--tool codex-cli`	Also works for Codex Desktop settings
Codex Desktop	Codex CLI MCP config	`--tool codex-desktop`	Uses same MCP registry as CLI
OpenCode	Global config (`~/.config/opencode/opencode.json`)	`--tool opencode`	Auto-updated by installer
Gemini	`gemini mcp add`	`--tool gemini`	User scope setup
Google Antigravity	Gemini-compatible MCP flow	`--tool antigravity`	Uses Gemini MCP command path
GitHub Copilot	`copilot` or `gh copilot` session	`--tool copilot`	Interactive/session-based setup

For LLM

If you are an LLM agent setting up this MCP server, here is everything you need:

Before trying UI automation tools, remember that Accessibility permission usually belongs to the host/runtime process (node, terminal, MCP client), not the target app under automation.

Quick start (one command)

# Register baepsae as an MCP server for all supported clients

bash scripts/install.sh --tool all

If you installed via npm instead of cloning the repo, use npx:

# Claude Code

claude mcp add baepsae -- npx -y mcp-baepsae@latest

Codex CLI

codex mcp add baepsae -- npx -y mcp-baepsae@latest

Automation flags

# Preview commands without executing

bash scripts/install.sh --tool all --dry-run

Verify environment and dependencies

bash scripts/install.sh --tool all --doctor

Unregister from all clients

bash scripts/install.sh --tool all --uninstall

Runtime options

The installer supports multiple runtimes via --runtime:

Flag	Command	When to use
`--runtime node` (default)	`node dist/index.js`	Local source build
`--runtime npx`	`npx -y mcp-baepsae@latest`	npm registry, no global install
`--runtime bunx`	`bunx mcp-baepsae@latest`	Bun users
`--runtime global`	`mcp-baepsae`	After `npm install -g mcp-baepsae`

Manual Setup (Fallback)

Use this when you do not want to run scripts/install.sh.

Using npx (recommended for npm users)

# Claude Code

claude mcp add baepsae -- npx -y mcp-baepsae@latest

Codex CLI

codex mcp add baepsae -- npx -y mcp-baepsae@latest

Gemini CLI

gemini mcp add --scope user --transport stdio baepsae npx -y mcp-baepsae@latest

When using npx, the relevant Accessibility entry is commonly the spawned node runtime plus the terminal / MCP client that launched it.

Using local build

# Claude Code (project)

claude mcp add --scope project --env="BAEPSAE_NATIVE_PATH=/ABS/PATH/native/.build/release/baepsae-native" baepsae -- node /ABS/PATH/dist/index.js

Codex CLI

codex mcp add baepsae --env BAEPSAE_NATIVE_PATH=/ABS/PATH/native/.build/release/baepsae-native -- node /ABS/PATH/dist/index.js

Gemini CLI

gemini mcp add --scope user --transport stdio -e BAEPSAE_NATIVE_PATH=/ABS/PATH/native/.build/release/baepsae-native baepsae node /ABS/PATH/dist/index.js

When using a local build, check permission on both the runtime (node) and the app that launched it. If you invoke baepsae-native directly for debugging, check permission on the native binary entry itself as well.

Project Structure

MCP server entry point: src/index.ts
Tool modules: src/tools/ (info, simulator, ui, input, media, system)
Shared utilities: src/utils.ts, src/types.ts
Native binary entry point: native/Sources/main.swift
Native command handlers: native/Sources/Commands/
Native binary output: native/.build/release/baepsae-native
TS tests: tests/mcp.contract.test.mjs, tests/unit.test.mjs, tests/mcp.real.test.mjs
Swift tests: native/Tests/BaepsaeNativeTests/

Commands

npm run build       # Build TypeScript + native Swift binary

npm test # Contract/integration tests npm run test:real # Real simulator smoke test (requires booted simulator) npm run test:real:preflight # Environment diagnostics only npm run test:real:sim # iOS simulator phases only (skips Phase 4) npm run test:real:mac # macOS Safari phase only npm run verify # test + test:real npm run setup:mcp # Alias for scripts/install.sh

MCP Tool Status

43 tools implemented end-to-end.

Official public MCP surface: unified generic tools

The public API surface is intentionally single-scheme: use unified generic tools with a target argument, rather than sim_* / mac_* names.

Category	Tools
UI	`analyze_ui`, `query_ui`, `tap`, `tap_tab`, `type_text`, `swipe`, `scroll`, `drag_drop`, `wait_for_ui`, `detect_dialog`, `read_ui_value`, `set_ui_value`, `read_ui_param`, `hit_test`, `enumerate_ui`
Input	`key`, `key_sequence`, `key_combo`, `touch`, `input_source`, `list_input_sources`
Workflow	`run_steps`
System	`list_windows`, `activate_app`, `screenshot_app`, `right_click`, `focus_window`, `context_menu_action`, `watch_notification`
Simulator-only	`list_simulators`, `screenshot`, `record_video`, `stream_video`, `open_url`, `install_app`, `launch_app`, `terminate_app`, `uninstall_app`, `button`, `gesture`
macOS/system	`list_apps`, `menu_action`, `get_focused_app`, `clipboard`
Utility	`baepsae_help`, `baepsae_version`, `doctor`

Target routing is explicit in the arguments: udid for simulator, bundleId / appName for macOS.

`type_text` policy

type_text accepts exactly one input source: text, stdinText, or file.

method: "auto" resolves to:
paste for simulator targets
keyboard for macOS targets
method: "paste" uses the simulator pasteboard for simulator targets and a temporary host clipboard replace/restore flow for macOS targets.
method: "keyboard" always types character-by-character.

When paste is used, simulator targets update the simulator pasteboard without touching the host clipboard, while macOS targets temporarily overwrite the host clipboard and restore it after submission. Successful responses report the input source, target kind, requested method, used method, paste transport, and any auto fallback that was applied.

`tap_tab` policy

tap_tab is semantic-first, geometry-last.

First it tries actionable descendants exposed under the tab bar.
If SwiftUI/Simulator does not expose real tab button descendants, it can use a semantic proxy row (for example, app-provided top navigation buttons that map cleanly to the same tabs).
Only if neither semantic path exists does it fall back to tab-bar geometry.

This matters because SwiftUI TabView in Simulator may expose the tab bar as a generic AXGroup text="Tab Bar" without actionable child buttons.

Usage Examples

Switch tabs by index with semantic-first fallback:

// Prefer this when your app exposes a real tab bar but individual tab buttons

// are not consistently addressable via query_ui/tap selectors. tap_tab({ udid: "...", index: 1, tabCount: 3 })

**Unified simulator app accessibility quickstart (i

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Baepsae

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

topo^alpin

README vom Entwickler

mcp-baepsae

Table of Contents

Prerequisites

Platform Support

Permissions

Which process usually needs permission?

Recommended setup flow

Important note

Install

Option A) npm (easiest)

Or install globally

Option B) From source

MCP Setup (Recommended)

Client Matrix

For LLM

Quick start (one command)

Codex CLI

Automation flags

Verify environment and dependencies

Unregister from all clients

Runtime options

Manual Setup (Fallback)

Using npx (recommended for npm users)

Codex CLI

Gemini CLI

Using local build

Codex CLI

Gemini CLI

Project Structure

Commands

MCP Tool Status

Official public MCP surface: unified generic tools

type_text policy

tap_tab policy

Usage Examples

`type_text` policy

`tap_tab` policy