Remote Desktop Commander

リモートデスクトップコマンダー

どこからでも、コンピューター上で構築、探索、自動化できます。

リモート MCP コネクターに対応した AI アプリから、コンピューターのファイルシステムとターミナルにアクセスできます。Remote Desktop Commander は、実際のコンピューターへのセキュアな接続を中継するホステッド MCP サーバーです。キーボードの前にいなくても、AI アシスタントがローカルサーバーと同じように、ファイルやシェルにフルアクセスできます。

• サーバーエンドポイント： https://mcp.desktopcommander.app/mcp（Streamable HTTP、OAuth 2.0）
• ダッシュボード： mcp.desktopcommander.app
• ステータス： 現在ベータ版です
• デモ： 動画を見る

このリポジトリでは、ホステッドサービスの公開マニフェスト、ドキュメント、課題トラッカーを管理しています。サービスの実装はオープンソースではありません。オープンソースのローカル（stdio）サーバーについては、DesktopCommanderMCPをご覧ください。

できること

• ゼロから構築 — 簡単なコマンドで機能やアプリケーションを作成します
• 開発環境を管理 — サーバーをセットアップし、システムを設定し、プロセスを管理します
• 既存のコードベースを探索 — 複雑なリポジトリを調べて理解します
• ドキュメントをその場で編集 — Word、Excel、PDF ファイルをディスク上の保存場所で編集します
• コンテキストとドキュメントを管理 — プロジェクトの詳細や技術仕様を把握します
• 複数のマシンを操作 — 複数のコンピューターをペアリングし、1 つの会話内で名前を指定して操作します

クイックスタート

1. デバイスエージェントを起動する

操作するコンピューターで：

npx @wonderwhy-er/desktop-commander@latest remote

ブラウザーで確認ページが開き、ペアリングコードが表示されます（標準的な OAuth デバイスフローの確認のため、ターミナルにも表示されます）。サインインし、コードが一致することを確認すると、ターミナルに「Device ready」と表示されます。エージェントは起動したままにしてください。ターミナルを閉じるとアクセスできなくなります。

2. AI クライアントを接続する

初回接続時、各クライアントで OAuth サインインの手順が案内されます。

claude.ai / Claude Desktop — Settings → Connectors → Add custom connector の順に選択し、次を入力します：

https://mcp.desktopcommander.app/mcp

Claude Code：

claude mcp add --transport http remote-desktop-commander https://mcp.desktopcommander.app/mcp

（このリポジトリをチェックアウトしたディレクトリ内で作業している場合、Claude Code は同梱の .mcp.json も自動的に読み込みます。）

ChatGPT — Settings → Apps & Connectors → Advanced settings の順に選択し、Developer mode を有効にします（対応するプランが必要です）。次に Create connector を選択して、次を入力します：

https://mcp.desktopcommander.app/mcp

Cursor — ワンクリックで追加できます：Cursor に追加。または、手動で ~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "remote-desktop-commander": {
      "url": "https://mcp.desktopcommander.app/mcp"
    }
  }
}

VS Code — エージェントプラグインをインストールします（このサーバーが含まれています）：

copilot plugin install desktop-commander/remote-desktop-commander

または、ワークスペースの .vscode/mcp.json（もしくはユーザーレベルの mcp.json）にサーバーを直接追加します：

{
  "servers": {
    "remote-desktop-commander": {
      "type": "http",
      "url": "https://mcp.desktopcommander.app/mcp"
    }
  }
}

Gemini CLI：

gemini extensions install https://github.com/desktop-commander/remote-desktop-commander

3. 試してみる

エージェントが実行中のどのマシンでも、セットアップなしで次の操作を行えます：

「ホームディレクトリの内容を一覧表示して、何があるか教えてください。」

「Documents フォルダーに ai-test というフォルダーを作成してください。その中に日付を表示する短い Python スクリプトを書いて、実行してください。」

「マシン上で Python REPL を起動し、pandas をインポートして、インストールされているバージョンを教えてください。セッションは終了せずに維持してください。」

「ホームディレクトリから過去 24 時間以内に変更されたファイルを検索し、フォルダーごとにまとめてください。」

トラブルシューティングを含む詳しい手順：docs/SETUP.md

必要条件

• 操作する各コンピューターに Node.js 18 以降（npx 用）
• マシンごとに、デバイスエージェントを実行するターミナルが 1 つ必要です
• macOS、Windows、Linux に対応しています

利用可能なツール

カテゴリー	ツール
読み取りと確認	ファイルを読み取る、複数のファイルを読み取る、ディレクトリを一覧表示する、ファイル情報を取得する
検索	検索を開始する、検索結果をさらに取得する、検索を停止する、実行中の検索を一覧表示する
書き込みと編集	ファイルを書き込む、ファイルのブロックを編集する、ファイルを移動または名前変更する、ディレクトリを作成する、PDFを書き込むまたは変更する
ターミナルとプロセス	プロセスを開始する、プロセスに入力を送信する、プロセスの出力を読み取る、アクティブなセッションを一覧表示する、システムプロセスを一覧表示する、セッションを終了する、システムプロセスを強制終了する
デバイスとアカウント	ペアリング済みデバイスを一覧表示する、現在のユーザー情報、デバイスに ping を送信する、デバイスエージェントをシャットダウンする
設定とヘルプ	設定を取得する、設定値を指定する、プロンプトライブラリを取得する、最近のツールのアクティビティを取得する、使用統計を取得する、フィードバックを送信する

仕組み

sequenceDiagram
    participant AI as AI app (web, mobile, desktop)
    participant S as mcp.desktopcommander.app
    participant D as Your computer (device agent)
    AI->>S: MCP tool call (OAuth 2.0 bearer)
    S->>D: relayed to your paired device
    D->>D: executes locally
    D->>S: result
    S->>AI: MCP response

• 認証には標準の PKCE を用いた OAuth 2.0 を使用します。デバイスは OAuth デバイス認証フロー（セットアップ時に表示される短いコードによる承認）でペアリングします。
• サーバーはツール呼び出しを通じて明示的に要求されたデータにのみアクセスします。データの送信は HTTPS/TLS によって暗号化されます。
• デバイスにアクセスできるのは、デバイスエージェントの実行中のみです。Ctrl+C で停止すると、アクセスできなくなります。デバイスはいつでもダッシュボードで確認し、アクセスを取り消せます。
• ツールはペアリング済みマシン上でお使いのユーザーアカウントの権限を使って実行されます。そのため、接続した AI アカウントは認証情報と同じように扱い、MFA で保護してください。完全な信頼モデルについては、SECURITY.mdをお読みください。

サポートと法的情報

• セットアップガイド： docs/SETUP.md
• バグと機能のリクエスト： GitHub Issues · 貢献： CONTRIBUTING.md
• コミュニティ： Discord
• セキュリティに関する報告： SECURITY.mdをご覧ください
• プライバシーポリシー： Remote Desktop Commander のプライバシーポリシー · 利用規約： legal.desktopcommander.app
• ライセンス： LICENSE — このリポジトリにはドキュメントとマニフェストのみが含まれています。ホステッドサービスはプロプライエタリです。

関連リンク

• DesktopCommanderMCP — オープンソースのローカル MCP サーバー（npm：@wonderwhy-er/desktop-commander）。ペアリングに使用する remote デバイスエージェントも同梱されています。
• desktopcommander.app — 製品サイト