Claude Desktop Commander MCP

Claude Desktop Commander MCP

簡単に言うと、重要な機能は 2 つです。ターミナルコマンドと、差分ベースのファイル編集です。

このサーバーを使うと、Claude デスクトップアプリで Model Context Protocol（MCP）を介して、コンピューター上の長時間実行されるターミナルコマンドを実行したり、プロセスを管理したりできます。さらに、MCP Filesystem Server を基盤としており、ファイルの追加検索・置換編集機能を提供します。

機能

• ターミナルコマンドを実行し、出力をストリーミング
• コマンドのタイムアウトとバックグラウンド実行に対応
• プロセス管理（プロセスの一覧表示と終了）
• 長時間実行されるコマンドのセッション管理
• ファイルシステムのすべての操作：
  • ファイルの読み取り／書き込み
  • ディレクトリの作成／一覧表示
  • ファイル／ディレクトリの移動
  • ファイルの検索
  • ファイルのメタデータ取得
  • コード編集機能：
  • 小規模な変更向けのピンポイントなテキスト置換
  • 大規模な変更向けのファイル全体の書き換え
  • 複数ファイルに対応
  • パターンベースの置換

インストール

まず、Claude Desktop アプリをダウンロードしてインストールし、npm をインストールしてください。

オプション 1：Smithery 経由でインストール

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

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 を使い、コマンドを停止します

Model Context Protocol の統合

このプロジェクトは MCP Filesystem Server を拡張し、以下を実現します。

• Claude Desktop でのローカルサーバーのサポート
• システムコマンドの完全な実行
• プロセス管理
• ファイル操作
• 検索／置換ブロックを使用したコード編集

Claude MCP を探求する取り組みの一環として作成されました：https://youtube.com/live/TlbjFDbl5Us

コントリビューション

このプロジェクトが役に立った場合は、GitHub で ⭐ スターを付けていただけると幸いです。これにより、ほかの人がプロジェクトを見つけやすくなり、さらなる開発の励みになります。

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

• バグを見つけましたか？ github.com/wonderwhy-er/ClaudeComputerCommander/issues で Issue を作成してください
• 機能のアイデアがありますか？ Issues セクションで機能をリクエストしてください
• コードに貢献したいですか？ リポジトリをフォークし、ブランチを作成して、プルリクエストを送信してください
• 質問や議論がありますか？ GitHub Discussions タブでディスカッションを始めてください

大小を問わず、すべてのコントリビューションに心より感謝します。

ライセンス

MIT