MD

mb-dev/macos-ui-automation-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

33 stars 5 forks 品質 47 トレンド 11

これは、Claude に任意の macOS アプリケーションで確認し、やり取りする機能を与える MCP (モデルコンテキストプロトコル) サーバーです。Playwright は Web ブラウザーではなく、ネイティブ Mac アプリケーションで動作します.

概要

これは、Claude に任意の macOS アプリケーションで確認し、やり取りする機能を与える MCP (モデルコンテキストプロトコル) サーバーです。Playwright は Web ブラウザーではなく、ネイティブ Mac アプリケーションで動作します。 - 🧪 - "私のアプリでログインフローをテスト" - "すべてのボタンが適切にラベルされているかどうかをチェック" - ✔ - "このフォームを消去し、それを提出" - ◀ - "Finderのすべてのインタラクティブ要素を表示する" - : システム設定 → プライバシーとセキュリティ → アクセシビリティに追加 - : VS コードをシステム設定に追加 → プライバシー & セキュリティ → アクセシビリティ - : システム設定 → プライバシー & セキュリティ → アクセシビリティーに追加 親アプリはMCPサーバーを実際に実行するので、許可が必要です.

概要(AI 翻訳)

ライク・プレイライト, ネイティブのmacOSアプリケーション用. Claudeを通して自然言語で任意のMacアプリを制御 - 人工知能によるMacアプリケーションの開発とテストに最適です。

確かにこれは何ですか?

これは、Claude に任意の macOS アプリケーションで確認し、やり取りする機能を与える MCP (モデルコンテキストプロトコル) サーバーです。Playwright は Web ブラウザーではなく、ネイティブ Mac アプリケーションで動作します。

パーフェクト:

  • 🧪Macアプリケーションのテスト - “私のアプリでログインフローをテストする”
  • ANSI アプリ開発 - “すべてのボタンが適切にラベルされているかどうかを確認する”
  • ➡UIの自動化** - “このフォームを消去して送信”
  • ◀アプリ探索 - “Finderのすべてのインタラクティブ要素を表示”

すぐにスタート

##1. インストール

##2. アクセシビリティ権限の設定 ⚠️Critical:parentアプリケーションへのアクセシビリティを有効にします:

  • ターミナル利用の場合:ターミナルを[[[T0]に追加]
  • VSコードを使用する場合:VSコードを[[[T1]に追加]
  • Claude Code を使用する場合: Claude コードを [[[T2] に追加します

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Playwright MCP for macOS 🎭

Like Playwright, but for native macOS applications. Control any Mac app with natural language through Claude - perfect for developing and testing Mac applications with AI assistance.

🎯 What is this?

This is an MCP (Model Context Protocol) server that gives Claude the ability to see and interact with any macOS application - just like Playwright does for web browsers, but for native Mac apps.

Perfect for:

  • 🧪 Testing Mac applications - “Test the login flow in my app”
  • 🔍 App development - “Check if all buttons are properly labeled”
  • 🤖 UI automation - “Fill out this form and submit it”
  • 📱 App exploration - “Show me all the interactive elements in Finder”

🚀 Quick Start

1. Install

git clone https://github.com/mb-dev/macos-ui-automation-mcp.git
cd macos-ui-automation-mcp
uv sync

2. Set Up Accessibility Permissions

⚠️ Critical: Enable accessibility for your parent application:

  • If using Terminal: Add Terminal to System Settings → Privacy & Security → Accessibility
  • If using VS Code: Add VS Code to System Settings → Privacy & Security → Accessibility
  • If using Claude Code: Add Claude Code to System Settings → Privacy & Security → Accessibility

The parent app needs permission because it’s the one actually executing the MCP server.

3. Configure Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "macos-ui-automation": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/macos-ui-automation-mcp",
        "run",
        "macos-ui-automation-mcp"
      ]
    }
  }
}

4. Start Automating!

Now you can ask Claude things like:

  • “Find all buttons in the Calculator app”
  • “Click the submit button in my app”
  • “Click the screenshot button to capture the current window”
  • “Test the login flow by filling in credentials and clicking submit”

🛠 Available Tools

Tool Description Use Case
find_elements Find UI elements using JSONPath “Show me all text fields”
find_elements_in_app Search within a specific app “Find buttons in Safari”
click_by_accessibility_id Click using accessibility actions “Click the submit button”
click_at_position Click at screen coordinates “Click at position (100, 200)”
type_text_to_element_by_selector Type text into elements “Type ‘hello’ into the search field”
get_app_overview Overview of running applications “What apps are currently running?”
GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "macos-ui-automation": { "command": "uv", "args": [ "--directory", "/absolute/path/to/macos-ui-automation-mcp", "run", "macos-ui-automation-mcp" ] } } }