macOS Screen View & Control MCP Server

macOS Screen View & Control MCP Server

ウィンドウのスクリーンショット機能を提供する Model Context Protocol サーバーです。このサーバーを使うと、LLM は macOS 上の特定のウィンドウを、ウィンドウタイトルまたはウィンドウ ID で指定してスクリーンショットを撮影できます。

利用可能なツール

• capture_window_screenshot - タイトルまたは ID を指定して、特定のウィンドウのスクリーンショットを撮影します

  • window_identifier（string、必須）：検索するウィンドウタイトルまたはウィンドウ ID
  • search_in_owner（boolean、任意）：ウィンドウのオーナー名も検索するかどうか（デフォルト：true）
  • format（string、任意）：出力形式（binary または base64）（デフォルト："binary"）

• list_windows - 表示中のすべてのウィンドウを一覧表示します

  • パラメーターは必要ありません

• find_window - タイトルまたはオーナー名でウィンドウを検索します

  • title（string、必須）：検索するウィンドウタイトルまたはオーナー名
  • search_in_owner（boolean、任意）：ウィンドウのオーナー名も検索するかどうか（デフォルト：true）

• send_key - アクティブなウィンドウにキーボードのキー押下イベントを送信します

  • key（string、必須）：押すキー（例：'a'、'return'、'space'）
  • modifiers（文字列のリスト、任意）：押したままにする修飾キーのリスト（例：['command', 'shift']）

• type_text - テキスト文字列を入力します

  • text（string、必須）：入力するテキスト
  • delay（float、任意）：キー入力間の遅延時間（秒）（デフォルト：0.1）

対応キー

以下のキーに対応しています。

• 英字：a-z（大文字・小文字を区別しません）
• 数字：0-9
• 特殊キー：return、tab、space、delete、escape
• 矢印キー：up_arrow、down_arrow、left_arrow、right_arrow
• 修飾キー：command、shift、control、option（right_shift、right_option、right_control も使用できます）

使用例

キーを 1 回押します。

await send_key("return")

修飾キーと組み合わせてキーを押します。

await send_key("c", ["command"])  # Command+C (copy)

テキストを入力します。

await type_text("Hello, World!")

インストール

pip を使用する

macos_screen_mcp を pip でインストールします。

pip install git+ssh://[email protected]/jhead/macos-screen-mcp.git

インストール後、次のようにスクリプトとして実行できます。

python -m macos_screen_mcp

設定

設定方法

Claude または Cursor の設定に追加します。

"mcpServers": {
 "macos-screen": {
    "name": "macos-screen",
    "url": "http://localhost:8000/sse",
    "description": "MCP server for capturing window screenshots",
    "version": "1.0.0"
  }
}

デバッグ

MCP inspector を使用してサーバーをデバッグできます。

npx @modelcontextprotocol/inspector python -m macos_screen_mcp

コントリビュート

macos-screen-mcp の拡張と改善につながるコントリビュートを歓迎します。新しいツールの追加、既存機能の強化、ドキュメントの改善など、皆さんの貢献は大切です。

プルリクエストを歓迎します！新しいアイデア、バグ修正、機能強化などをぜひお寄せください。macos-screen-mcp をさらに強力で便利なものにしていきましょう。

ライセンス

macos-screen-mcp は MIT License のもとでライセンスされています。MIT License の利用規約に従うことを条件として、このソフトウェアを自由に使用、変更、配布できます。詳しくは、プロジェクトリポジトリの LICENSE ファイルをご覧ください。