Desktop Commander MCP

Desktop Commander MCPとは？

Desktop Commander MCPは、AI言語モデル（Claude Desktopなど）とローカルマシンとの間で高度なシステムレベルのインタラクションを可能にするモデルコンテキストプロトコル（MCP）サーバーです。これは、ターミナルコマンド、ファイル管理、コード編集、自動化といった重要な開発者ツールをラップし、Claude Desktopを介して直接働く安全なインターフェイスの背後に配置することで、典型的なAIエディタを超えて拡張されます。これにより、Claudeは完全なコードベースの探索、正確な変更、自動化スクリプト、そしてIDE内だけでなくオペレーティングシステム全体にわたるワークフロー管理が可能な多用途の開発者アシスタントに変わります。

Desktop Commander MCPの設定方法

1. Claude Desktopをインストール: Claude Desktopをダウンロードしてインストールします。
2. npxによるクイックインストール: ターミナルでnpx @wonderwhy-er/desktop-commander@latest setupを実行します。
3. その他のインストールオプション:
   • Smithery CLIを使用して、npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claudeでインストールします。
   • macOS用のbashスクリプトを使用: curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash
   • claude_desktop_config.jsonを編集し、mcpServersの下にサーバー設定を追加します。
   • または、git clone ...、npm run setupを使用してローカルにクローン/ビルドします。
4. セットアップ後にClaude Desktopを再起動して、新しいMCPサーバーを有効にします。
5. 設定を構成:
   • Claudeチャット内のget_config({})およびset_config_value({ key, value })ツールを使用して、ブロックされたコマンド、allowedDirectories、またはデフォルトシェルなどのオプションを調整します。
   • 構成変更を常にget_config({})で確認してください。
   • セキュリティのために、専用の構成チャットを維持し、正確なディレクトリアクセス制限を指定します。

設定は、サーバーの作業ディレクトリ内のconfig.jsonに永続化されます。Claudeに「テレメトリを無効にする」と要求することで、テレメトリを直接無効化できます。

Desktop Commander MCPの使い方

1. Claude Desktopを起動し、新しいチャットを開きます。
2. 自然言語を使用して対話: Claudeにファイルの読み取り、検索、編集、ターミナルコマンドの実行、またはプロセスの管理などの操作を依頼します。Claudeは対応するMCPツールを呼び出します。
3. 手動ツール呼び出し: MCPツール関数名を直接使用できます。例:

   execute_command({ "command": "ls -la", "shell": "/bin/zsh" })
   read_file({ "path": "README.md" })
   edit_block({ "changes": "...edit block format..." })
   

4. 長時間実行されるタスクの処理:
   • バックグラウンドで続けているプロセスについては、list_sessionsを使用して監視し、read_outputでコマンド出力を取得し、force_terminateで停止します。
5. テキスト/コード検索および編集:
   • 編集ブロック構文を使用して正確な置換を行います。
   • search_code、search_files、edit_blockのようなツールを使用して、洗練されたコードベースの変更を実施し、調整します。
6. シェルの切り替え:
   • コマンドツールのshell引数を介してお好みのシェルを選択します。例: bash、zsh、またはpowershell。

インターフェイスを介してタスクをシームレスに自動化し、システムスクリプトを実行し、ファイルとプロセスを管理し、コードを編集できます。すべてはClaudeとの会話を通じて実現されます。

主な機能

• ターミナルコマンドの実行: ライブ出力、タイムアウト、カスタムシェルを使用してコマンドを実行します。
• バックグラウンドプロセス管理: 実行中のプロセスやターミナルセッションをリスト、監視、停止します。
• 構成管理: サーバー設定を取得/設定し、コマンド制限やディレクトリアクセスを再起動なしで更新します。
• ファイルシステム操作: ファイル/ディレクトリの読み取り、書き込み、移動、検索、情報取得を行い、バッチ操作やパターン検索をサポートします。
• アーカイバル検索/編集: あいまいなマルチ発生テキスト/コード検索と、セキュアな編集ブロック形式を使用したパターン置換。
• 高度なコード編集: 外科的テキスト変更、マルチファイルサポート、パターンマッチング、および深層コードベース探索のためのripgrepとの統合。
• 画像とURLの処理: read_fileはローカルファイルとリモートWebリソースの両方をプレビューおよび分析でき、テキストと画像の両方をサポートします。
• セキュリティコントロール: 許可されたディレクトリを定義し、リスクのあるコマンドをブロックし、テレメトリをレビューします（オプトアウトサポートあり）。
• クロスプラットフォーム: macOS、Windows、Linuxで完全に機能し、自動的に環境に特化した修正を行います。

使用例

• 数分で大規模または複雑なコードベースを探索、検索、理解
• 複数ファイル/プロジェクトにわたる正確で外科的なリファクタリングまたはパッチ作成
• コード/テキストを抽出・処理してドキュメントまたは図を生成
• 単一のチャットインターフェイスから繰り返しまたはクロスプロジェクトの開発者タスクを自動化
• AIによるシステムスクリプト、環境設定、プロセス管理の実施
• プロセス、ビルド、サーバー実行の迅速なデバッグ、試行実行、または終了
• パーソントークンAPIコストなしで複数のOS環境での作業

FAQ

1. Desktop Commander MCPとは？ Claude DesktopがファイルシステムとOSと完全に対話する能力を高めるMCPサーバーであり、コードベースの探索、詳細なコード編集、自動化、ターミナル/プロセス制御を自然言語を通じて実現します。

2. CursorやWindsurfのようなツールとは異なりますか？ Desktop Commander MCPは、任意のIDEを超える広範なOSレベルの制御を提供し、マルチプロジェクトおよびマルチディレクトリのワークフローをサポートし、フルファイルアクセス（チャンクではなく）を提供し、追加のパーソントークンAPIコストなしでClaude Desktop Proプランを活用します。

3. Desktop CommanderはAPIクレジットや追加料金を必要としますか？ いいえ—Claude Desktop Proをお持ちの場合、すべての操作はローカルで行われ、追加の使用料やパーソントークン料金は発生しません。

4. Desktop Commanderを更新するにはどうすればよいですか？ npxまたはSmitheryからインストールした場合、Claude Desktopを再起動するとDesktop Commanderは自動的に更新されます。手動インストールの場合は、セットアップコマンドを再実行してください。

5. テレメトリデータは収集されていますか？ テレメトリは最小限で、デフォルトでは個人情報を含みません。Claudeに「テレメトリを無効にする」と要求することで、いつでもオプトアウトできます。