mcp-リモート-macos-使用

MCP サーバー - リモート MacOs の使用

AI がリモート macOS システムを完全に制御できるようにする最初のオープンソース MCP サーバー。

OpenAI Operator の直接的な代替品であり、完全なデスクトップ機能を備えた自律 AI エージェント向けに特別に最適化されており、追加のソフトウェアのインストールは必要ありません。

ショーケース

Twitter を調べて Twitter に投稿する( https://www.youtube.com/watch?v=--QHz2jcvcs )
CapCut を使用して短いハイライトビデオを作成します ( https://www.youtube.com/watch?v=RKAqiNoU8ec )
AIリクルーター: メールアプリを使用して候補者情報の収集、応募書類の適格性評価、スクリーニングセッションの送信を自動化
AIマーケティングインターン：LinkedInエンゲージメント - 関連ユーザーへの自動フォロー、いいね、コメント
AIマーケティングインターン：Twitterエンゲージメント - 関連ユーザーへの自動フォロー、いいね、コメント

ToDoリスト（優先順位付き）

パフォーマンスの最適化- Ubuntuデスクトップの代替品と同等の速度
Apple Scripts 生成- 柔軟性を維持しながら実行時間を短縮
VNCカーソルの可視性- デバッグとデモのエクスペリエンスを向上

貢献を歓迎します!

特徴

追加のAPIコストなし：既存のClaude Proプランでスクリーン処理が無料
最小限のセットアップ: 対象のMacで画面共有を有効にするだけで、追加のソフトウェアは必要ありません。
ユニバーサルな互換性: 現在および将来のすべてのmacOSバージョンで動作します

なぜこれを作ったのか

妥協のないネイティブmacOSエクスペリエンス

macOSネイティブエコシステムは、今日でも比類のないユーザーエクスペリエンスを提供し、今後も長年にわたりゴールドスタンダードであり続けるでしょう。人間の能力が真に発揮されるのはまさにこの環境であり、AIもこの環境で人間と同等の流暢さで動作できるようになります。

オープンアーキテクチャ設計

ユニバーサル LLM 互換性: 任意の MCP クライアントで動作します
モデルの柔軟性: OpenAI、Anthropic、その他のLLMプロバイダーとシームレスに統合
将来を見据えた統合: MCPエコシステムに合わせて進化する設計

簡単な導入

ターゲットマシンでのセットアップは不要: macOSではバックグラウンドアプリケーションやエージェントは不要
画面共有だけが必要なわけではありません: 画面共有を有効にすれば、どのMacでも操作できます
バックエンドの複雑さを排除: Pythonアプリケーションやバックグラウンドサービスの実行を必要とする他のソリューションとは異なり、

合理化されたブートストラッププロセス

Claude Desktopの洗練されたUIを活用する：開発者スタイルのPythonインターフェースは不要
直感的なユーザーエクスペリエンス: 使い慣れたユーザーフレンドリーなインターフェースを通じて、AI制御のMacを操作します。
即時の生産性:設定の手間をかけずにすぐに作業を開始できます

建築

インストール

MacOSで画面共有を有効にするmacstadium.comからMacをレンタルする場合は、この手順をスキップできます。
リモートMacOsに接続する
ローカル Mac に Docker Desktop をインストールする
この MCP サーバーを Claude Desktop に追加します。Claude構成に以下を追加することで、Claude Desktop が Docker イメージを使用するように構成できます。

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_macos_username",
        "-e",
        "MACOS_PASSWORD=your_macos_password",
        "-e",
        "MACOS_HOST=your_macos_hostname_or_ip",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    }
  }
}

LiveKit経由のWebRTCサポート

このサーバーには、LiveKit 統合による WebRTC サポートが含まれるようになり、次のことが可能になります。

低遅延のリアルタイム画面共有
パフォーマンスと応答性の向上
従来のVNCに比べてネットワーク効率が向上
ネットワーク状況に基づく自動品質適応

WebRTC 機能を使用するには、次のことが必要です。

LiveKitサーバーをセットアップするか、LiveKitクラウドを使用する
上記の設定例のようにLiveKit環境変数を設定します。

開発者向け指示

リポジトリをクローンする

# Clone the repository
git clone https://github.com/yourusername/mcp-remote-macos-use.git
cd mcp-remote-macos-use

Dockerイメージの構築

# Build the Docker image
docker build -t mcp-remote-macos-use .

クロスプラットフォームパブリッシング

複数のプラットフォーム向けにDockerイメージを公開するには、 docker buildxコマンドを使用します。以下の手順に従ってください。

新しいビルダーインスタンスを作成します(まだ作成していない場合)。
docker buildx create --use
複数のプラットフォーム用のイメージをビルドしてプッシュします。
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-remote-macos-use:latest --push .
指定されたプラットフォームでイメージが使用可能であることを確認します。
docker buildx imagetools inspect buryhuang/mcp-remote-macos-use:latest

使用法

サーバーは、MCP ツールを通じてリモート MacOs 機能を提供します。

ツールの仕様

サーバーは、リモート macOS 制御用に次のツールを提供します。

リモート_macos_get_screen

リモートmacOSマシンに接続し、リモートデスクトップのスクリーンショットを取得します。接続の詳細は環境変数を使用します。

リモートMacOSキー送信

キーボード入力をリモートmacOSマシンに送信します。接続の詳細については環境変数を使用します。

リモート_macos_マウス_移動

マウスカーソルをリモートmacOSマシン上の指定座標に移動し、座標の自動スケーリングを行います。接続の詳細については環境変数を使用します。

リモート_macos_マウス_クリック

リモートmacOSマシン上の指定された座標でマウスクリックを実行し、座標のスケーリングを自動で行います。接続の詳細については環境変数を使用します。

リモート_macos_マウス_ダブルクリック

リモートmacOSマシン上の指定座標でマウスのダブルクリックを実行し、座標の自動スケーリングを行います。接続の詳細については環境変数を使用します。

リモート_macos_マウス_スクロール

リモートmacOSマシン上の指定した座標でマウススクロールを実行します。座標は自動的にスケーリングされます。接続の詳細については環境変数を使用します。

リモート_macos_オープン_アプリケーション

アプリケーションを開いてアクティブ化し、以降の操作のためにその PID を返します。

リモート_macos_マウス_ドラッグ_アンド_ドロップ

自動座標スケーリングを使用して、リモート macOS マシン上で開始点からマウスのドラッグ操作を実行し、終了点にドロップします。

すべてのツールは、接続パラメータを必要とせず、セットアップ時に構成された環境変数を使用します。

制限事項

認証サポート:
- Apple認証（プロトコル30）のみがサポートされています

セキュリティに関する注意事項

https://support.apple.com/guide/remote-desktop/encrypt-network-data-appdfe8e386b/mac https://cafbit.com/post/apple\_remote\_desktop\_quirks/

512ビットの素数を使用するDiffie-Hellman鍵共有プロトコルを使用するプロトコル30のみをサポートしています。このプロトコルは、macOS 11からmacOS 12で、OS X 10.11以前のクライアントと通信する際に使用されます。

マークダウンテーブルに変換された情報は次のとおりです。

リモートデスクトップを実行しているmacOSバージョン	macOSクライアントバージョン	認証	制御と観察	アイテムをコピーするかパッケージをインストールする	その他すべてのタスク	プロトコルバージョン
macOS 13	macOS 13	2048ビットRSAホストキー	2048ビットRSAホストキー	認証には2048ビットRSAホストキーを使用し、その後128ビットAESを使用する	2048ビットRSAホストキー	36
macOS 13	macOS 10.12	ローカルのみのセキュアリモートパスワード（SRP）プロトコル。LDAPにバインドされている場合、またはmacOSサーバーのバージョンが10.11以前の場合は、Diffie-Hellman（DH）プロトコル。	SRPまたはDH、128ビットAES	SRPまたはDHで認証し、その後128ビットAESで認証する	2048ビットRSAホストキー	35
macOS 11からmacOS 12へ	macOS 10.12からmacOS 13	ローカルのみのセキュアリモートパスワード (SRP) プロトコル、LDAP にバインドされている場合は Diffie-Hellman	SRPまたはDH 1024ビット、128ビットAES	2048 ビット RSA ホストキー macOS 13 から macOS 10.13	2048ビットRSAホストキー macOS 10.13以降	33
macOS 11からmacOS 12へ	OS X 10.11以前	DH 1024ビット	DH 1024ビット、128ビットAES	512ビットの素数を持つDiffie-Hellman鍵共有プロトコル	512ビットの素数を持つDiffie-Hellman鍵共有プロトコル	30

リモートのMacOSマシンにアクセスする際は、必ず安全で認証された接続を使用してください。このツールは、信頼できるサーバーでのみ使用し、アクセス権限を与えてください。

ライセンス

詳細については、LICENSE ファイルを参照してください。

mcp-remote-macos-use

Integrations