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

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

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

特徴

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

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

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

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

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

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

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

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

  • ファイルを検索

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

  • コード編集機能:

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

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

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

  • パターンベースの置換

インストール

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

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

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

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

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

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

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

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

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

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

1. クローンとビルド:

実行中の場合は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 が失敗した場合に最適)

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

例：

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

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

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

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

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

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

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

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

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

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

• プロセス管理

• ファイル操作

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

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

貢献

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

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

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

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

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

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

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

ライセンス

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