Macos Screen MCP

🚀 macOS 屏幕视图与控制 MCP サーバ

このサーバは、Model Context Protocol（MCP）に基づき、macOS上の特定のウィンドウのスクリーンショットを取得する機能を提供します。大型言語モデル（LLMs）は、ウィンドウのタイトルまたはウィンドウIDを指定することで、目的のウィンドウのスクリーンショットを取得できます。

✨ 主な機能

提供されているツール

• capture_window_screenshot - 指定されたウィンドウのスクリーンショットを取得します。ウィンドウのタイトルまたはIDで識別できます。

  • window_identifier (文字列、必須)：検索するウィンドウのタイトルまたはウィンドウID
  • search_in_owner (ブール値、オプション)：ウィンドウの所有者名で検索するかどうか（デフォルト：true）
  • format (文字列、オプション)：出力形式（バイナリまたはbase64）（デフォルト："binary"）

• list_windows - すべての可視ウィンドウをリストします。

  • パラメータは不要です。

• find_window - タイトルまたは所有者名に基づいてウィンドウを検索します。

  • title (文字列、必須)：検索するウィンドウのタイトルまたは所有者名
  • search_in_owner (ブール値、オプション)：ウィンドウの所有者名で検索するかどうか（デフォルト：true）

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

  • key (文字列、必須)：押すキー（例："a"、"return"、"space"）
  • modifiers (文字列のリスト、オプション)：押し続ける修飾キーのリスト（例：["command", "shift"]）

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

  • text (文字列、必須)：入力するテキスト
  • delay (浮動小数点数、オプション)：キー間の遅延時間（秒単位、デフォルト：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も含む）

💻 使用例

基本的な使用法

単一のキーを送信する例：

await send_key("return")

高度な使用法

修飾キーを使用する例（Command+C でコピー）：

await send_key("c", ["command"])

テキストを入力する例：

await type_text("Hello, World!")

📦 インストール

pipを使用する場合

macos_screen_mcpをpipを使ってインストールします。

pip install git+ssh://git@github.com/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 サーバを使用してウィンドウのスクリーンショットを取得する",
    "version": "1.0.0"
  }
}

デバッグ方法

MCPインスペクタを使用してサーバをデバッグできます。

npx @modelcontextprotocol/inspector python -m macos_screen_mcp

🤝 コントリビューション

macos-screen-mcpの拡張や改善に向けたコントリビューションを歓迎します。新機能の追加、既存機能の強化、ドキュメントの改善など、あなたの意見は大切です。

プルリクエストを歓迎します！新しいアイデア、バグ修正、または改善点を自由に提案してください。

📄 ライセンス

macos-screen-mcpはMIT Licenseの下でライセンスされています。これは、あなたがこのソフトウェアを自由に使用、変更、配布できることを意味しますが、MIT Licenseの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。