1A

1amageek/app-mcp

Developer tools

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

21 stars 2 forks 品質 38 トレンド 10

aIモデルとmacOSアプリケーション間のギャップを埋め、視覚検査、UIの解釈、およびネイティブアプリケーションの正確な制御によるインテリジェントな自動化を可能にします.

概要

aIモデルとmacOSアプリケーション間のギャップを埋め、視覚検査、UIの解釈、およびネイティブアプリケーションの正確な制御によるインテリジェントな自動化を可能にします。 - : ScreenCaptureKitを使用して高解像度アプリウィンドウをキャプチャ - : AppleのVision Frameworkを使用してスクリーンショットからテキストを抽出 - : 正確な要素をターゲットにするための詳細なアクセシビリティ階層を抽出 - : 複数の実行中のアプリケーションを同時に識別し、監視します - : マウスクリック、キーボード入力、ジェスチャー自動化 - : インテリジェントな遅延と条件ベースの待機メカニズム - : 信頼できる自動化のための強力なフォールバック戦略 - : シームレスなTCC(透明性、一貫性、制御)の統合 - : 構造化されたエラー処理でSTDIO上のJSON-RPC - : 強化されたセキュリティを対象とする検証アプリケーション AppMCP では、以下の macOS 権限が必要です。 1. : システム環境設定 → プライバシーとセキュリティ → アクセシビリティ 2.

概要(AI 翻訳)

モデルコンテキストプロトコルによるAI-Powered macOSアプリケーションオートメーション

AppMCPは、AIモデルとmacOSアプリケーション間のギャップを埋め、視覚的な検査、UIの解釈、およびネイティブアプリケーションの正確な制御によるインテリジェントな自動化を可能にします。

お問い合わせ

✨ 機能

確かにビジュアルインテリジェンス

-スマートスクリーンショット: ScreenCaptureKitを使用した高解像度アプリウィンドウのキャプチャ

  • OCRテキスト認識: AppleのVision Frameworkを使用してスクリーンショットからテキストを抽出する
  • UIツリー分析:正確な要素のターゲティングのための詳細なアクセシビリティ階層を抽出 -Multi-App Discovery:複数の実行中のアプリケーションを同時に識別し、監視する
✓自動化ツールキット**
  • 優先インタラクション: マウスクリック、キーボード入力、ジェスチャー自動化 -Smart Waiting:インテリジェントな遅延と条件ベースの待機メカニズム
  • Recovery:信頼できるオートメーションのための強力なフォールバック戦略

プライバシーポリシー

  • 権限管理:シームレスなTCC(透明性、一貫性、制御)統合 -Secure Communication:STDIO上のJSON-RPC構造エラー処理

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

README

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

🤖 AppMCP

AI-Powered macOS Application Automation via Model Context Protocol

AppMCP bridges the gap between AI models and macOS applications, enabling intelligent automation through visual inspection, UI interpretation, and precise control of native applications.


✨ Features

🎯 Visual Intelligence

  • Smart Screenshots: Capture high-resolution app windows using ScreenCaptureKit
  • OCR Text Recognition: Extract text from screenshots using Apple’s Vision Framework
  • UI Tree Analysis: Extract detailed accessibility hierarchies for precise element targeting
  • Multi-App Discovery: Identify and monitor multiple running applications simultaneously

🛠 Automation Toolkit

  • Precise Interactions: Mouse clicks, keyboard input, and gesture automation
  • Smart Waiting: Intelligent delays and condition-based waiting mechanisms
  • Error Recovery: Robust fallback strategies for reliable automation

🔒 Privacy & Security

  • Permission Management: Seamless TCC (Transparency, Consent, and Control) integration
  • Secure Communication: JSON-RPC over STDIO with structured error handling
  • Bundle ID Validation: Verified application targeting for enhanced security

🚀 Quick Start

Prerequisites

  • macOS 15.0+ (Sequoia or later)
  • Swift 6.1+
  • Xcode 16.0+

Installation

# Clone the repository
git clone https://github.com/your-username/AppMCP.git
cd AppMCP

# Build the project
swift build -c release

# Run the daemon
./.build/release/appmcpd --stdio

Permissions Setup

AppMCP requires the following macOS permissions:

  1. 🔓 Accessibility: System Preferences → Privacy & Security → Accessibility
  2. 📺 Screen Recording: System Preferences → Privacy & Security → Screen Recording

The application will guide you through the permission setup process.


🎮 Usage Examples

Weather App Automation

import json
import subprocess

# Start AppMCP server
process = subprocess.Popen(['./appmcpd', '--stdio'])

# Take screenshot of Weather app
request = {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "resources/read",
    "params": {"uri": "app://app_screenshot"}
}

# Send request and get response
response = send_mcp_request(request)
print(f"📸 Screenshot captured: {response['result']['contents'][0]['text']}")

UI Element Discovery

# Get accessibility tree
request = {
    "jsonrpc": "2.0",
    "id": 2,
    "method": "resources/read",
    "params": {"uri": "app://app_accessibility_tree"}
}

tree = send_mcp_request(request)
GitHub で README 全文を見る

インストール

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

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