Baepsae

Name: Baepsae
Author: oozoofrog

作者：oozoofrogバージョン 6.3.0i★ –iパソコンで動く

レジストリ名io.github.oozoofrog/baepsae

インストール

概要

作者による説明（英語の原文）

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: その他

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
レジストリには、入力が必要なキーは載っていません。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

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

ターミナルでこれを実行します

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

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

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

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月6日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント oozoofrog で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの32476件のうち0%よりスターが多い
このカテゴリのほかの32476件のうち5%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの32476件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Baepsaeは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（6.3.0）がレジストリに届いたのは7 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, zanadir

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

作者：formulahendry

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

パソコンで動く★ 440MIT14 か月前更新

インストール

Remote Desktop Commander

作者：desktop-commander

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

クラウドで動く★ 211昨日更新

インストール

zanadir

作者：MustacheCase

Find what a repository's CI is missing, and which security checks cannot fail the build.

パソコンで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

冒頭だけを表示しています。続きはリポジトリで読めます

Baepsae

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

zanadir

作者のREADME

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