クロード デスクトップ コマンダー 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のディスカッションタブで議論を始めてください。

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

ライセンス

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