MCP Server Macos Use

🚀 macOSでのMCPサーバーの使用

モデルコンテキストプロトコル（MCP）サーバーはSwiftで記述されています。このサーバーは、Accessibility APIを通じてmacOSアプリケーションを制御することを可能にし、主にMacosUseSDKを介して実現されます。

Claude Desktopやその他の互換性のあるMCPクライアントに使用することができます。

このサーバーは、標準入出力（stdio）を通じてMCPコマンドを監視し、アプリケーションとの対話に役立つさまざまなツールを提供します。

GitHubアセットリンク

✨ 主な機能

📦 利用可能なツール

CallTool MCPメソッドを通じて、サーバーは以下のツールを提供します。

1. macos-use_open_application_and_traverse

   • 説明: 指定されたアプリケーションを開くかアクティブ化し、そのアクセシビリティツリーをトラバースします。
   • パラメータ:
     • identifier (String, 必須): アプリケーションの名前、バンドルID、またはファイルパス。

2. macos-use_click_and_traverse

   • 説明: ターゲットアプリケーション（PIDで識別）のウィンドウ内の特定の座標でマウスクリックをシミュレートし、そのアクセシビリティツリーをトラバースします。
   • パラメータ:
     • pid (Number, 必須): ターゲットアプリケーションのプロセスID (PID)。
     • x (Number, 必須): クリックするX座標（ウィンドウ/画面に対する相対座標、SDKの動作に依存）。
     • y (Number, 必須): クリックするY座標。

3. macos-use_type_and_traverse

   • 説明: ターゲットアプリケーション（PIDで識別）でテキスト入力をシミュレートし、そのアクセシビリティツリーをトラバースします。
   • パラメータ:
     • pid (Number, 必須): ターゲットアプリケーションのプロセスID (PID)。
     • text (String, 必須): 入力するテキスト。

4. macos-use_click_and_traverse

   • 説明: ターゲットアプリケーション（PIDで識別）のウィンドウ内の特定の座標でマウスクリックをシミュレートし、そのアクセシビリティツリーをトラバースします。
   • パラメータ:
     • pid (Number, 必須): ターゲットアプリケーションのプロセスID (PID)。
     • x (Number, 必須): クリックするX座標（ウィンドウ/画面に対する相対座標、SDKの動作に依存）。
     • y (Number, 必須): クリックするY座標。

🔧 依存関係

• MacosUseSDK: macOSアプリケーションとの対話に使用されるローカルまたは外部のSwiftパッケージ。

📦 インストール

サーバーをビルドして実行するには、以下のコマンドを実行してください。

swift build

次に、以下のコマンドでサーバーを実行します。

./mcp-server-macos-use/.build/debug/mcp-server-macos-use

💻 使用例

基本的な使用法

Claude Desktopなどの設定ファイルでMCPサーバーの位置を指定するには、以下のようにします。

{
    "mcpServers": {
        "mcp-server-macos-use": {
            "command": "/path/to/your/project/mcp-server-macos-use/.build/debug/mcp-server-macos-use"
        }
    }
}

/path/to/your/project/ を実際のプロジェクトの絶対パスに置き換えてください。

📚 ドキュメント

連絡先

ヘルプが必要な場合は、matt@mediar.ai までご連絡ください。
Discord: m13v_

このサーバーをあなたのニーズに合わせてカスタマイズすることも可能です。問題やメールでのご連絡を歓迎します。