wonderwhy-er/DesktopCommanderMCPView GitHub Homepage for Latest Official Releases

Desktop Commander MCPは、Claude向けに設計されたMCPサーバーで、ターミナル制御、ファイルシステム検索、差分ファイル編集機能をClaudeに提供します。

MITJavaScriptDesktopCommanderMCPwonderwhy-er 4.1k Last Updated: August 07, 2025

Desktop Commander MCP プロジェクト詳細

プロジェクト概要

Desktop Commander MCP は、モデルコンテキストプロトコル (MCP) に基づくサーバーツールであり、Claude Desktop アプリケーション専用に設計されています。MCP プロトコルを通じて、Claude にターミナル制御、ファイルシステム検索、および差分ファイル編集機能を提供し、Claude を強力な開発アシスタントに変えます。

このプロジェクトは、MCP ファイルシステムサーバーの機能を拡張し、開発者が Claude を通じてローカルシステムを直接操作し、コマンドを実行し、ファイルを管理し、コードを編集できるようにすることで、従来の AI エディターの能力範囲を超えます。

主要な機能特性

🖥️ ターミナル操作

  • コマンド実行: ターミナルコマンドを実行し、出力ストリーミングをサポート
  • タイムアウト制御: 設定可能なコマンドタイムアウトとバックグラウンド実行をサポート
  • プロセス管理: 実行中のプロセスをリストおよび終了
  • セッション管理: 長時間実行コマンドのセッション管理をサポート
  • マルチシェルサポート: bash、zsh、powershell などの異なるシェル環境をサポート

📁 ファイルシステム操作

  • ファイル読み書き: 完全なファイルの読み取りおよび書き込み機能
  • ディレクトリ管理: ファイルおよびディレクトリの作成、リスト、移動
  • ファイル検索: ファイル名に基づく検索機能
  • メタデータ取得: ファイルおよびディレクトリの詳細情報を取得
  • マルチファイルサポート: 複数のファイルを同時に読み取り
  • URL 内容読み取り: URL からテキストおよび画像コンテンツを読み取ることをサポート

✏️ コード編集能力

  • 精密置換: 小規模な変更に対する外科手術的なテキスト置換
  • 完全書き換え: 大幅な変更に対する完全なファイル書き換え
  • マルチファイルサポート: 複数のファイルを同時に編集
  • パターン置換: パターンに基づくテキスト置換
  • コード検索: vscode-ripgrep を使用した再帰的なコードまたはテキスト検索

⚙️ サーバー構成管理

  • 構成取得/設定: 構成値の取得および設定
  • 一括更新: 複数の設定を一度に更新
  • 動的構成: サーバーを再起動せずに構成を変更
  • セキュリティ制御: 特定のコマンドのブロックおよびディレクトリアクセス制限をサポート

インストール方法

方法 1：NPX 快速インストール（推奨）

npx @wonderwhy-er/desktop-commander@latest setup

方法 2：macOS 自動インストール

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

方法 3：Smithery インストール

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

方法 4：手動構築インストール

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

主要なツール分類

構成管理ツール

  • get_config: 完全なサーバー構成を取得
  • set_config_value: 特定の構成値を設定

ターミナルツール

  • execute_command: ターミナルコマンドを実行
  • read_output: 実行中のセッションの新しい出力を読み取り
  • force_terminate: 実行中のセッションを強制終了
  • list_sessions: すべてのアクティブなターミナルセッションをリスト
  • list_processes: すべての実行中のプロセスをリスト
  • kill_process: PID を介してプロセスを終了

ファイルシステムツール

  • read_file: ローカルファイルまたは URL コンテンツを読み取り
  • read_multiple_files: 複数のファイルを同時に読み取り
  • write_file: ファイルの内容を完全に置き換え
  • create_directory: ディレクトリを作成
  • list_directory: ディレクトリの詳細なリストを取得
  • move_file: ファイルおよびディレクトリを移動または名前変更
  • search_files: 名前でファイルを検索
  • search_code: ファイルの内容でテキスト/コードパターンを検索
  • get_file_info: ファイルまたはディレクトリの詳細なメタデータを取得

テキスト編集ツール

  • edit_block: 外科手術的なテキスト置換を適用

技術的優位性

従来の IDE ツールとの比較

  • 全システムソリューション: IDE 環境に限定されず、オペレーティングシステム全体を操作可能
  • 完全なファイル読み取り: Claude はファイルを分割処理するのではなく、完全に読み取り可能
  • マルチプロジェクトサポート: 複数のプロジェクトを同時に処理可能
  • 一括実行: 変更を一度に実行でき、繰り返しの確認を削減

コスト効率

  • Claude Desktop の標準 Pro サブスクリプション（$20/月）に基づく
  • 追加の API 呼び出し費用は不要
  • 自動更新メカニズム、NPX または Smithery でインストール時に最新バージョンを自動的に取得

使用シーン

開発シーン

  • 複雑なコードベースの探索と理解
  • 図表およびドキュメントの生成
  • クロスシステムタスクの自動化
  • 複数のプロジェクトを同時に作業
  • 正確なコード修正

セキュリティ特性

  • 設定可能なブロックコマンドリスト
  • 許可されたディレクトリアクセス制御
  • プロセス管理と監視
  • 構成の永続化と検証

Star History Chart