Desktop CommanderでClaude Desktopに端末制御とファイル編集を追加する方法

Claude Desktop などの AI クライアントに、ローカル PC のターミナル制御・ファイル編集・プロセス管理を丸ごと任せたい。そう考えてリサーチを始めると、真っ先に候補として挙がるのが wonderwhy-er/DesktopCommanderMCP（以下、Desktop Commander）です。

一方で、公式の modelcontextprotocol/servers に含まれる filesystem サーバーとの違いや、Cursor・Windsurf といった AI コーディング IDE との住み分け、6 種類あるインストール方法のうち自分のプロジェクトに合うのはどれか、といった判断ポイントが多く、初見のエンジニアが「本当に採用してよいか」まで即決するのは難しいのが実情です。

Desktop Commander の README は非常に情報量が多く、機能一覧・対応クライアント・セキュリティモデル・ライセンス・スポンサー導線までを網羅していますが、その分「まず何を見て判断すればよいか」の優先順位が読み取りにくい構造になっています。

本記事では、公式 GitHub リポジトリと公式サイトのドキュメントをベースに、Desktop Commander の位置づけ・主要機能・導入方法・想定ユースケース・類似 MCP サーバーとの違い・セキュリティ観点・メンテナンス状況を整理します。動作検証は行わず、あくまでドキュメント記載の事実をもとに、採用判断のチェックポイントとしてまとめます。読み終えたときに「自分の環境で採用するか」「するならどのインストール方法を選ぶか」を自力で判断できる状態を目指します。

Desktop Commander とは：Claude Desktop に端末とファイル編集を与える MCP サーバー

プロダクトの位置づけと開発の背景

Desktop Commander は、Claude Desktop などの MCP（Model Context Protocol）互換クライアントに対して、ターミナル制御・ファイルシステム操作・差分ベースのコード編集・プロセス管理を提供する OSS の MCP サーバーです。リポジトリ本体は wonderwhy-er/DesktopCommanderMCP で公開されており、実装言語は TypeScript、パッケージは npm 上の @wonderwhy-er/desktop-commander として配布されています。

Desktop Commander は、MCP のリファレンス実装群である modelcontextprotocol/servers の src/filesystem サーバー（ファイル読み書き・ディレクトリ操作・パターン検索を提供する軽量サーバー）を土台とし、そこにターミナル実行・対話的プロセス制御・差分編集・Excel/PDF/DOCX 対応などを積み増した派生実装として位置づけられています。作者は README や関連記事の中で、「AI エディタ以上のことを、ホストクライアントのサブスクリプション（Claude Desktop 等）だけで実現する」ことを繰り返し強調しており、API トークン課金を回避しやすい点を差別化ポイントとして打ち出しています。

リポジトリの基本情報

gh api /repos/wonderwhy-er/DesktopCommanderMCP で取得した本記事執筆時点のメタデータは以下のとおりです。

archived=false かつ fork=false であり、本家として独立して運用されているリポジトリです。最終 push が本記事執筆時点で 2026 年 7 月 18 日と直近であるため、少なくとも現時点では活発にメンテナンスされていると読み取れます。ライセンスも MIT のため、業務プロジェクトへの組み込み判断は比較的しやすい部類に入ります。

Desktop Commander の主要機能：端末制御・ファイル操作・差分編集

Desktop Commander の README には Available Tools として、Configuration / Terminal / Filesystem / Search / Text Editing / Analytics の 6 カテゴリのツールが列挙されています。ここでは、filesystem サーバー単体に対して Desktop Commander が上乗せしている領域を中心に、機能カテゴリを整理します。詳細な引数仕様は Available Tools セクションを確認してください。

ターミナル制御と対話的プロセス操作

Terminal カテゴリのツール（start_process / interact_with_process / read_process_output / force_terminate / list_sessions / list_processes / kill_process）は、Desktop Commander を「単なるファイル操作 MCP」ではなく「OS 全体の作業を任せられる MCP サーバー」に押し上げている中心的な機能群です。

start_process で立ち上げたプロセスに対して、interact_with_process で継続的に入力を送り、read_process_output で結果を受け取るという流れになっており、いわゆる REPL・SSH・データベースクライアントなどの対話的なコマンドを AI 側から扱えるように設計されています。プロセスの生死を管理する list_sessions / force_terminate / list_processes / kill_process も併せて提供されているため、AI が起動しっぱなしにしたシェルを後から回収するといった運用も想定されています。

ファイルシステム操作と Excel/PDF/DOCX ネイティブ対応

Filesystem カテゴリでは read_file / read_multiple_files / write_file / write_pdf / create_directory / list_directory / move_file / get_file_info が提供されます。単純なファイル読み書きに加え、list_directory は再帰オプション・階層深度指定・コンテキストオーバーフロー保護を持ち、大規模なリポジトリを対象にしても AI 側の context を破綻させにくい設計になっています。

READMEでは、Excel（.xlsx / .xls / .xlsm）・PDF（読み込み・作成・改変）・DOCX（surgical XML editing / markdown 変換）へのネイティブ対応も特徴として挙げられています。汎用ファイルシステム MCP としては珍しく、業務ドキュメントを AI 側から直接扱えるため、コード作業に閉じないデスクワークの自動化ユースケースを想定していることが読み取れます。加えて、read_file に isUrl: true を渡すと画像・テキストのリモート URL を読み込めるようになっており、簡易的な Web コンテンツ取得も MCP 側でカバーする方針が採られています。

Search カテゴリは vscode-ripgrep をベースにした start_search / get_more_search_results / stop_search / list_searches を提供します。対話型セッションで大量の検索結果をバッチ的に返すのではなく、非同期にストリーミング処理する構造になっており、複数プロジェクト横断のコード探索にも耐えられる設計です。

差分ベースの edit_block（surgical edit）

Text Editing カテゴリの中核が edit_block です。README では、対象ファイルのパスに続けて <<<<<<< SEARCH / ======= / >>>>>>> REPLACE マーカーで検索文字列と置換文字列を挟む形式で差分編集を指示する例が示されています。

src/main.js
<<<<<<< SEARCH
console.log("old message");
=======
console.log("new message");
>>>>>>> REPLACE

（出典: wonderwhy-er/DesktopCommanderMCP README — Available Tools）

edit_block は完全一致による surgical edit を基本としつつ、fuzzy search fallback により多少の差分（空白・改行の揺れ）を吸収する挙動が README に記載されています。同一箇所の複数出現への対応や、Excel のセル範囲の書き換えといった、単純な文字列置換を超える差分編集ユースケースが想定されています。

設定管理と監査ログ

Configuration カテゴリの get_config / set_config_value は、blockedCommands / defaultShell / allowedDirectories / fileReadLineLimit / fileWriteLineLimit / telemetryEnabled といった動作モードを実行中に切り替えるためのツールです。プロジェクトごとに許可ディレクトリを絞ったり、危険なコマンドをブロックリストで抑制したりする、いわゆる運用面の制御を AI クライアントから行える設計になっています。

Analytics カテゴリの get_usage_stats / get_recent_tool_calls / give_feedback_to_desktop_commander は、AI がどのツールをどのくらい呼び出しているかを可視化する目的のツール群で、後述する監査ログとあわせて運用状況の把握に使えます。

対応 AI クライアントとインストール方法

対応する MCP クライアントの範囲

Desktop Commander は Claude Desktop 以外の主要 MCP クライアントに対しても導入手順が整備されています。README にリストアップされている対応クライアントは以下のとおりです。

• Claude Desktop
• Cursor / Windsurf
• VS Code（GitHub Copilot 経由）
• Cline / Roo Code
• Claude Code（claude mcp add コマンド経由）
• Trae / Kiro
• Codex（OpenAI）
• JetBrains AI Assistant
• Gemini CLI / Qwen Code
• Augment Code

このうち特筆すべきは、Claude Code のように公式 CLI から直接 MCP サーバーとして登録できるクライアントと、claude_desktop_config.json などの JSON 設定ファイルに手動でエントリを追加するクライアントで、導入手順が微妙に異なる点です。日常的に併用しているクライアントが複数ある場合、統一された設定を持ちにくいことは事前に把握しておくべきポイントです。なお、Claude Code 側で複数の MCP サーバーを組み合わせて管理する手順や接続デバッグの流れは、Claude Code MCPサーバーの選び方と組み合わせレシピ｜接続デバッグ手順【2026年6月版】に整理しているため、Claude Code を主戦場として使う場合はあわせて確認してください。

6 種類のインストール方法の比較軸

Desktop Commander の README は 6 種類のインストール方法を提示しています。それぞれの特性を「自動更新の有無」「Node.js 前提の有無」「ホスト隔離の有無」の 3 軸で整理すると、以下のようになります。

README 冒頭で推奨されているのは Option 1 の npx セットアップで、次のコマンド 1 本で Claude Desktop 側の設定まで自動的に書き換えてくれます。

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

（出典: wonderwhy-er/DesktopCommanderMCP README — Installation）

一方で、claude_desktop_config.json を手動編集する Option 4 の場合、README では次のような JSON 例が示されています。

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander@latest"
      ]
    }
  }
}

（出典: wonderwhy-er/DesktopCommanderMCP README — Installation）

Docker で導入する Option 6 は、Node.js を PATH に置きたくない環境や、AI に任せる作業を明示的にコンテナ内に閉じ込めたい場合に選ばれる想定です。後述するセキュリティ観点でも、README は本番運用向けに Docker インストールを推奨しています。アンインストールは npx @wonderwhy-er/desktop-commander@latest remove で一括対応できると記載されています。

Remote MCP による ChatGPT / Claude Web 対応

Desktop Commander は上記のローカルインストールとは別に、Remote MCP エンドポイント（https://mcp.desktopcommander.app）を通じて、ChatGPT・Claude Web などの「ローカル PC を直接持たないクライアント」からも利用できる導線を用意しています。プロダクト全体の位置づけや料金モデル、Desktop Commander App（Beta）などの周辺プロダクトは 公式サイト に集約されています。

Desktop Commander が向く想定ユースケース

公式サイトはターゲットとしてビルダー・ナレッジワーカー・データアナリストの 3 層を挙げており、README の Quick Examples でもコード探索・データ分析・SSH 越しの操作などが並列に紹介されています。裏返せば、Desktop Commander は「AI にコードだけを書かせるツール」ではなく、「AI にローカル環境全体の作業を任せるツール」として設計されています。

コード探索・複数プロジェクト横断作業

Filesystem と Search のツール群は、複数のリポジトリを横断してコードの位置を特定したり、依存関係を素早く把握したりする用途に向いた設計になっています。list_directory の depth 指定や context overflow 保護、vscode-ripgrep ベースの start_search などは、大規模モノレポや複数プロジェクトの並行作業を想定した機能と読み取れます。単一 IDE のインデックスに依存しない探索を、Claude Desktop 側から一貫して行いたいケースに適合します。

データ分析（CSV / Excel / PDF / DOCX）

Excel / PDF / DOCX への native 対応と edit_block の Excel range 更新は、README でも Data Analysis 用途として紹介されています。手元にある CSV や Excel を AI に読ませて、そのまま同じファイルに集計結果を書き戻す、あるいは PDF を生成するといったフローが、追加のツールなしで完結できることを想定していると読み取れます。

SSH やデータベースなど対話的プロセスの利用

start_process / interact_with_process の対話的プロセス制御は、SSH でリモートサーバーに繋いで作業を継続したり、psql / mysql / redis-cli などの対話型 CLI を AI に操作させたりする用途に向いた設計です。REPL 系ツールのように「セッションを維持しながら複数コマンドを投げる」タイプの作業を、AI 側からも一貫したセッションとして扱えるようになっています。

類似 MCP サーバー・AI ツールとの違い

公式 modelcontextprotocol/servers の filesystem 実装との差分

MCP の公式リファレンス実装群である modelcontextprotocol/servers には、src/filesystem サーバーが含まれており、ファイル読み書き・ディレクトリ操作・パターン検索といった filesystem 系のツールが提供されています。Desktop Commander はこの filesystem サーバーを土台に、次の領域を追加する派生実装として位置づけられます。

• ターミナル・プロセス制御（start_process / interact_with_process ほか）
• 差分ベースの edit_block（surgical edit / fuzzy fallback）
• Excel / PDF / DOCX のネイティブサポート
• URL 読み取り（read_file の isUrl: true）
• 監査ログ・使用統計（Analytics カテゴリ）

「公式 filesystem サーバーで足りるか、それとも OS 全体に踏み込ませたいか」という選択軸で比較されるのが Desktop Commander の位置づけです。ファイル操作しか AI に任せない前提であれば公式 filesystem で十分ですが、AI にターミナル・データ処理・差分編集まで任せたい場合は Desktop Commander が候補に入ります。

Cursor / Windsurf など IDE 型 AI コーディングツールとの差分

Cursor や Windsurf は AI 特化型 IDE として、プロジェクトを開くエディタ内でファイル編集・チャット・補完を完結させるアプローチを採っています。一方 Desktop Commander は IDE ではなく MCP サーバーであり、Claude Desktop などの汎用 AI クライアントに「OS 横断のツールセット」を与える構造になっています。

作者本人による関連記事 Claude with MCPs replaced Cursor & Windsurf — How Did That Happen? では、ホストクライアントの購読料金（Claude Pro 等）だけで API トークン課金なしにコーディング作業を回せる点が、IDE 型 AI ツールとの実用上の差分として整理されています。エディタ内で完結する作業スタイルを崩したくない場合は IDE 型が向きますが、複数プロジェクトを横断しつつターミナル・データ処理まで任せたい場合は Desktop Commander のアプローチが噛み合います。

周辺の OS 自動化系 MCP サーバーとの差分

Windows-MCP / Playwright MCP / Peekaboo のように、GUI 自動化やブラウザ操作、OS 固有のウィンドウ制御に特化した MCP サーバーも公開されています。Desktop Commander はこれらとは棲み分けており、「ターミナル + ファイルシステム + テキスト編集」という開発者作業寄りの領域に照準を絞っています。GUI 操作やブラウザ自動化を主目的とする場合は、Desktop Commander ではなく用途特化型の MCP サーバーを並行して導入する構成が読み取れます。

セキュリティ・運用上の注意点

既知のセキュリティ制約（サンドボックスではない）

Desktop Commander の README と SECURITY.md は、「これはサンドボックスではない」ことを明示しています。allowedDirectories 設定は filesystem 系の操作にしか適用されず、ターミナルコマンドの実行範囲は制限されないと README に記載されており、シンボリックリンク・command substitution・絶対パス指定・任意コード実行といった経路で回避されうる旨も明記されています。「AI に何でも任せられるツール」であることは、裏返せば「AI が何でもできてしまうツール」でもある、というのが公式の立場です。

そのため業務環境で採用する場合は、権限を落とした専用ユーザーで動かす、外部リソースにアクセスできないネットワーク境界の下で動かす、といった OS 側の設計と併用することが前提となります。README では、本番運用向けには Docker インストール（Option 6）が推奨されており、ホスト隔離を積極的に活用する構成が示唆されています。

監査ログと blockedCommands による運用面の対策

Desktop Commander は監査ログを ~/.claude-server-commander/claude_tool_call.log に出力し、10MB でローテーションする設計になっています。AI が実際にどのツールをどのように呼び出したかを事後追跡できるため、事故発生時の原因調査や、社内ポリシー適合の証跡として活用できます。

set_config_value で blockedCommands を書き換えることで、誤爆抑制も可能です。ただし前述のとおり、これは filesystem 側の allowedDirectories と同じく、シンボリックリンクや command substitution を通した回避経路を完全に塞ぐものではない点は README で明示されています。「事故率を下げるための緩和策」として理解し、根本的な隔離は OS レベルで担保する運用が推奨されます。

本番運用向けの Docker 隔離オプション

Docker で導入する Option 6 は、mcp/desktop-commander:latest イメージを利用してコンテナ内で MCP サーバーを実行する構成です。README では production security 用途向けの推奨ルートとして明示されており、Node.js 環境をホストに構築する必要がない・自動更新される・ホストと隔離される、という 3 点が挙げられています。企業内で複数メンバーに配布する場合、環境差分によるトラブルを避けやすい点でも Docker ルートは選ばれやすい構成です。

ライセンスとメンテナンス状況

Desktop Commander は MIT ライセンスで配布されており、業務プロジェクトへの組み込みや社内配布に対する障壁は少ない部類に入ります。前述のとおり、本記事執筆時点でのメタデータは stargazers_count=8,510 / forks_count=940 / pushed_at=2026-07-18 であり、直近 30 日以内に push が発生しているアクティブなプロジェクトです。archived=false かつ fork=false であるため、本家として独立して運用されていることも確認できます。

コミュニティ面では、Discord による質疑応答チャネル、GitHub Sponsors / Buy Me A Coffee / Patreon のスポンサー導線が README に掲載されています。加えて npm ダウンロード週次バッジ、Smithery バッジ、Archestra AI MCP Catalog の Trust Score、AgentAudit Verified バッジ、Glama.ai サーバーカタログ掲載など、外部プラットフォームによる可視化・検証も進んでいます。個人メンテナンスの OSS ではありますが、複数のサードパーティ カタログに継続的に掲載されており、一定の第三者評価も伴っていることが読み取れます。

一方で、これは個人・小規模チームによる OSS 一般の話でもありますが、コア開発者側の稼働状況によりリリース頻度は将来的に変動する可能性があります。導入判断時は最新の pushed_at や Release ページを wonderwhy-er/DesktopCommanderMCP 側で直接確認することが望ましいアプローチです。

まとめ：Desktop Commander の採用を検討するときに見るべきポイント

Desktop Commander は、公式 modelcontextprotocol/servers の filesystem 実装を土台としつつ、ターミナル・プロセス制御・差分編集・Excel/PDF/DOCX 対応を積み増した、開発者作業向けの MCP サーバーです。IDE 型 AI コーディングツールと違い、Claude Desktop などの汎用 AI クライアントに OS 横断のツール群を与える構造になっており、ホストクライアントの購読料金だけで API トークン課金を回避しやすい点が実用上の差分として整理されています。

採用検討時のチェックポイントは、大きく次の 5 つに集約できます。

• 機能範囲: ファイル操作だけで済むなら公式 filesystem で十分。ターミナル・対話プロセス・差分編集・Excel/PDF/DOCX まで AI に任せたい場合は Desktop Commander が候補になる
• 対応クライアントとインストール方法: 主要 MCP クライアントを網羅している一方、6 種類あるインストール方法は「自動更新の有無」「Node.js 前提の有無」「ホスト隔離の有無」で性格が異なる。個人用途は npx セットアップ、本番運用は Docker、ローカル改造前提であれば git clone ルートが選ばれやすい
• 類似 MCP サーバーとの位置づけ: 公式 filesystem サーバー・IDE 型 AI ツール・GUI 自動化 MCP と役割を切り分けたうえで、「OS 横断のコード作業」に照準を絞ったサーバーであることを踏まえて採用可否を判断する
• セキュリティ制約: サンドボックスではないことを前提に、Docker 隔離や blockedCommands / allowedDirectories 設定、監査ログの活用、権限を絞ったユーザーでの実行といった OS 側の運用と併用する
• メンテナンス状況: MIT ライセンス・スター 8,510・最終 push 2026-07-18 と本記事執筆時点では活発だが、個人主導の OSS である以上、導入判断時は最新の pushed_at を GitHub 側で確認する

これらの観点を最新の README とあわせて確認したうえで、自プロジェクトのセキュリティ要件・運用体制と照らし合わせて採用可否を判断することが、初見エンジニアにとっての現実的な進め方です。詳細な機能仕様と最新の変更履歴は、常に 公式サイト と wonderwhy-er/DesktopCommanderMCP の README を一次ソースとして参照してください。