@superpms/jarvis-remote-hand-mcp

AI エージェントがあなたの所有する複数台のコンピューターをリモート制御し、システムコマンドを実行できるようにする MCP サービスです。典型的な用途は、複数台のマシンのネットワークなどのシステム問題を同時に調査・修復することです。

本サービスは自らログインしません。「远程控制助手」デスクトップ版の既存のログイン状態を借用します：agent → 本サービス → デスクトップ版 → MQTT → 対象デバイス。

前提条件

1. 1台のマシンで「远程控制助手」デスクトップ版が実行され、ログイン済みであること

2. 対象デバイスでもデスクトップ版が実行され、同じアカウントでログインし、オンラインであること

3. Node.js >= 20.19

Related MCP server: mcp-windows-server

設定

MCP クライアントの設定に以下を追加してください：

{
  "mcpServers": {
    "jarvis-remote-hand": {
      "command": "npx",
      "args": ["-y", "@superpms/jarvis-remote-hand-mcp"],
      "env": {
        "ARH_BRIDGE_URL": "http://127.0.0.1:47890",
        "ARH_BRIDGE_TOKEN": "在桌面端「MCP 服务配置」页复制"
      }
    }
  }
}

環境変数

アクセストークンについて

ブリッジインターフェースはログイン済みデバイスのシェルプロキシと同等であり、クロスマシン利用のためにLANで待ち受けているため、サーバー側でトークンの検証を強制しています。トークンはデスクトップ版のアプリケーションデータディレクトリに保存され、再起動しても変わりません。古いトークンを無効化するには「MCP サービス設定」ページで「リセット」をクリックし、その後すべてのエージェントの設定を新しい値に変更する必要があります。

health はトークンを検証しない唯一のインターフェースです。その存在意義は、トークンがまだペアリングされていない時でも「ブリッジが実際に動作しているかどうか」に答えられることです。そのため、固定の {"ok":true} のみを返し、他の情報は一切含みません。

クロスマシンアクセスには、対象マシンのファイアウォールで 47890 ポートを開放する必要もあります。

ツール

send_command の tool パラメータは対象デバイスのプラットフォームに応じて選択します：bash（macOS/Linux）、cmd または pws（Windows）。

使用手順

1. list_devices でオンラインデバイスの device_uuid を取得します

2. send_command で送信し、mid を取得します

3. query_mid を state が「完了」になるまでポーリングし、result を読み取ります

state は 送信中 → キュー待ち → 実行中 → 完了 の順に遷移します。被制御端は受信順に1件ずつ実行し、同時に実行されるのは1件だけです。

コマンド実行にタイムアウトはありません。数分から十数分かかるのは正常です（ネットワークリセット、一括インストールなど）。ポーリングで「実行中」になった場合は数秒間隔で続行し、失敗と判断したり再送信したりしないでください。

デバイスがオフラインの場合、または現在のアカウントに属していない場合、send_command は原因を説明するエラーを直接返し、結果が永遠に得られない mid を返すことはありません。

セキュリティについて

本サービスが転送するリクエストは、ログイン済みのデバイス上で任意のシステムコマンドを実行できます。信頼できるネットワーク内でのみ使用し、47890 ポートをパブリックネットワークに公開しないでください。また、アクセストークンを公開の場所に貼り付けないでください。

License

MIT