デスクトップコマンダーMCP

短いバージョン。重要な点が2つあります。ターミナルコマンドと、diffベースのファイル編集です。

目次

• 特徴

• インストール

• 使用法

• 長時間実行されるコマンドの処理

• 進行中の作業とTODO

• メディアリンク

• お客様の声

• 貢献

• ライセンス

これは、Claude デスクトップ アプリがコンピューター上で長時間実行されるターミナル コマンドを実行し、モデル コンテキスト プロトコル (MCP) を通じてプロセスを管理できるようにするサーバーです。MCPファイルシステム サーバー上に構築され、追加の検索および置換ファイル編集機能を提供します。

Related MCP server: MCP Tools

特徴

• 出力ストリーミングでターミナルコマンドを実行する

• コマンドタイムアウトとバックグラウンド実行のサポート

• プロセス管理（プロセスの一覧表示と終了）

• 長時間実行コマンドのセッション管理

• 完全なファイルシステム操作:

  • ファイルの読み取り/書き込み

  • ディレクトリの作成/一覧表示

  • ファイル/ディレクトリを移動する

  • ファイルを検索

  • ファイルのメタデータを取得する

  • コード編集機能:

  • 小さな変更のための外科的テキスト置換

  • 大きな変更があった場合はファイル全体を書き換える

  • 複数ファイルのサポート

  • パターンベースの置換

インストール

まず、 Claude デスクトップ アプリをダウンロードしてインストールし、 npm がインストールされていることを確認します。

オプション1: Smithery経由でインストールする

Smithery経由で Claude Desktop 用の Desktop Commander を自動的にインストールするには:

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

オプション2: npx経由でインストールする

ターミナルでこれを実行するだけです

npx @wonderwhy-er/desktop-commander setup

実行中の場合はClaudeを再起動します

オプション3: claude_desktop_configに手動で追加する

次のエントリを claude_desktop_config.json (Mac の場合は ~/Library/Application\ Support/Claude/claude_desktop_config.json にあります) に追加します。

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

実行中の場合はClaudeを再起動します

オプション4: 現地でチェックアウト

1. クローンとビルド:

git clone https://github.com/wonderwhy-er/ClaudeComputerCommander.git
cd ClaudeComputerCommander
npm run setup

実行中の場合はClaudeを再起動します

セットアップ コマンドは次の処理を実行します。

• 依存関係をインストールする

• サーバーを構築する

• Claudeのデスクトップアプリを構成する

• 必要に応じて、Claude の設定に MCP サーバーを追加します。

使用法

サーバーは次のツール カテゴリを提供します。

ターミナルツール

• execute_command : 設定可能なタイムアウトでコマンドを実行する

• read_output : 長時間実行コマンドからの出力を取得する

• force_terminate : 実行中のコマンドセッションを停止する

• list_sessions : アクティブなコマンドセッションを表示する

• list_processes : システムプロセスを表示する

• kill_process : PIDでプロセスを終了する

• block_command / unblock_command : コマンドブラックリストを管理する

ファイルシステムツール

• read_file / write_file : ファイル操作

• create_directory / list_directory : ディレクトリ管理

• move_file : ファイルの移動/名前変更

• search_files : パターンベースのファイル検索

• get_file_info : ファイルのメタデータ

編集ツール

• edit_block : 外科的なテキスト置換を適用する（ファイルサイズの 20% 未満の変更に最適）

• write_file : ファイルの完全な書き換え (20% を超える大きな変更や edit_block が失敗した場合に最適)

検索/置換ブロック形式:

filepath.ext
<<<<<<< SEARCH
existing code to replace
=======
new code to insert
>>>>>>> REPLACE

例：

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

長時間実行されるコマンドの処理

時間がかかる可能性があるコマンドの場合:

1. execute_commandタイムアウト後に初期出力で戻ります

2. コマンドはバックグラウンドで継続されます

3. 新しい出力を取得するには、PID を指定したread_output使用します。

4. 必要に応じてforce_terminateを使用して停止します

モデルコンテキストプロトコル統合

このプロジェクトは、MCP ファイルシステム サーバーを拡張して次の機能を実現します。

• Claude Desktop のローカルサーバーのサポート

• 完全なシステムコマンド実行

• プロセス管理

• ファイル操作

• 検索/置換ブロックを使ったコード編集

Claude MCP の探索の一環として作成されました: https://youtube.com/live/TlbjFDbl5Us

進行中の作業とTODO

現在、以下の機能が開発中または計画中です。

• より優れたコード検索（進行中） - コンテキストに応じた結果によるコード探索の強化

• より良い設定（進行中） - 許可されたパス、コマンド、シェル環境の設定が改善されました

• Windows 環境の修正(進行中) - Windows プラットフォーム固有の問題を解決します

• Linux の改善(進行中) - さまざまな Linux ディストリビューションとの互換性を強化

• WSL (Windows Subsystem for Linux 統合) のサポート

• SSHのサポート- リモートサーバーコマンド実行

• インストールのトラブルシューティングガイド- セットアップの問題に関する包括的なヘルプ

メディア

以下のリソースを通じてこのプロジェクトの詳細を学んでください。

記事

MCPを搭載したClaudeがCursorとWindsurfに取って代わりました。これはどのようにして実現したのでしょうか？ - モデルコンテキストプロトコル機能を備えたClaudeが開発者のワークフローにどのような変化をもたらしているかを詳細に検証します。

ビデオ

Claude Desktop Commander ビデオ チュートリアル- Commander を効果的にセットアップして使用する方法をご覧ください。

コミュニティ

サポートを受けたり、フィードバックを共有したり、他のユーザーとつながったりするには、 Discord サーバーに参加してください。

お客様の声

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgyyBt6\_ShdDX\_rIOad4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgztdHvDMqTb9jiqnf54AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=UgyQFTmYLJ4VBwIlmql4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8\&lc=Ugy4-exy166\_Ma7TH-h4AaABAg

https://medium.com/@pharmx/you-sir-are-my-hero-62cff5836a3e

貢献

このプロジェクトが役に立ったと感じたら、GitHubで⭐星を付けていただけると嬉しいです！これにより、他の人がこのプロジェクトを見つけやすくなり、さらなる開発が促進されます。

コミュニティからの貢献を歓迎します！バグを見つけた場合、機能のリクエストがある場合、またはコードに貢献したい場合は、以下の方法でご協力ください。

• バグを発見しましたか？ github.com/wonderwhy-er/ClaudeComputerCommander/issuesで問題を報告してください。

• **機能に関するアイデアをお持ちですか？**問題セクションから機能リクエストを送信してください。

• **コードを投稿したいですか？**リポジトリをフォークしてブランチを作成し、プルリクエストを送信してください。

• 質問や議論はありますか？ GitHubのディスカッションタブで議論を始めてください。

規模の大小を問わず、すべての貢献を大歓迎します。

このツールがワークフローにとって価値があると思われる場合は、プロジェクトのサポートを検討してください。

ライセンス

マサチューセッツ工科大学