Claudedesktopcommander

デスクトップコマンダーMCPは、Claudeデスクトップアプリがユーザーのコンピュータ上でターミナルコマンドを実行し、モデルコンテキストプロトコル（MCP）を通じてプロセスを管理できるサービスです。ターミナルコマンドの実行、プロセス管理、ファイルシステム操作、およびコード編集機能を提供し、長時間実行されるコマンドと差分ファイル編集をサポートしています。

開発者ツールオペレーティングシステム自動化 #ターミナル制御 #プロセス管理 #ファイル編集 #MCPプロトコル .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 6.4K

更新時間 : 2025-07-31

サイトを開く

デスクトップコマンダーMCPとは？

デスクトップコマンダーMCPは、Claude AIアシスタントが直接あなたのコンピュータと対話できるツールです。これにより、Claudeはターミナルコマンドの実行、プロセスの管理、ファイルシステムの操作、および正確なコード編集を行うことができます。

デスクトップコマンダーMCPの使い方は？

インストール後、Claudeデスクトップアプリ内で自然言語の命令を使用して、コマンドの実行、ファイルの編集、またはシステムプロセスの管理を直接行うことができます。

適用シーン

開発者が自然言語でコンピュータを制御して、コーディング、ファイル操作、およびシステム管理タスクを完了したいシーンに適しています。

主要機能

ターミナルコマンドの実行

様々なターミナルコマンドを実行し、リアルタイムで出力を取得します。

プロセス管理

システムプロセスの表示と終了を行います。

ファイル操作

ファイルの読み書き、ディレクトリの作成、ファイルの移動など、完全なファイルシステム操作を行います。

コード編集

正確な検索置換と完全なファイルの書き換えの2つの編集モードをサポートしています。

利点

ツールを切り替えることなく開発とシステム管理タスクを完了できます。

長時間実行されるコマンドとバックグラウンドプロセスをサポートしています。

正確なコード編集機能を提供します。

Claudeデスクトップアプリとシームレスに統合されています。

制限

現在、Windows環境のサポートはまだ改善中です。

設定と使用には一定の技術知識が必要です。

コマンドを実行する際には、セキュリティに注意する必要があります。

使い方

インストール

npmを通じてデスクトップコマンダーMCPをインストールします。

Claudeを再起動する

インストールが完了したら、Claudeデスクトップアプリを再起動します。

使用を開始する

Claude内で直接コマンドまたは編集要求を入力します。

使用例

プロジェクトの依存関係を更新する

Claudeにプロジェクトのnpm依存関係をチェックして更新させます。

コード内の特定の行を修正する

コードファイル内の特定の部分を正確に修正します。

よくある質問

インストール後、Claudeがコマンドを認識できない場合はどうすればいいですか？

コマンドの実行の安全性を確保するにはどうすればいいですか？

🚀 Desktop Commander MCP

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

🚀 クイックスタート

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

✨ 主な機能

出力ストリーミング付きでターミナルコマンドを実行
コマンドのタイムアウトとバックグラウンド実行のサポート
プロセス管理（プロセスの一覧表示と終了）
長時間実行されるコマンドのセッション管理
完全なファイルシステム操作:
- ファイルの読み取り/書き込み
- ディレクトリの作成/一覧表示
- ファイル/ディレクトリの移動
- ファイルの検索
- ファイルのメタデータの取得
- コード編集機能:
- 小さな変更のための外科的なテキスト置換
- 大きな変更のための完全なファイル書き換え
- 複数ファイルのサポート
- パターンベースの置換

📦 インストール

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

オプション1: Smitheryを通じてインストール

Smithery を通じてClaude Desktop用のDesktop Commanderを自動的にインストールするには、次のコマンドを実行します。

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: ローカルでチェックアウト

リポジトリをクローンしてビルドします。

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

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

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

execute_command はタイムアウト後に初期出力とともに戻ります。
コマンドはバックグラウンドで続行されます。
read_output をPIDとともに使用して新しい出力を取得します。
必要に応じて force_terminate を使用して停止します。

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

このプロジェクトはMCP Filesystem Serverを拡張して、次の機能を有効にします。

Claude Desktopでのローカルサーバーサポート
完全なシステムコマンド実行
プロセス管理
ファイル操作
検索/置換ブロックによるコード編集

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

開発中とTODO

現在開発中または計画されている機能は次のとおりです。

より良いコード検索 (開発中) - コンテキストを考慮した結果でコード探索を強化
より良い設定 (開発中) - 許可されたパス、コマンド、シェル環境の設定を改善
Windows環境の修正 (開発中) - Windowsプラットフォーム固有の問題を解決
Linuxの改善 (開発中) - さまざまなLinuxディストリビューションとの互換性を強化
WSLのサポート - Windows Subsystem for Linuxの統合
SSHのサポート - リモートサーバーのコマンド実行
インストールトラブルシューティングガイド - セットアップ問題の包括的なヘルプ

メディア

これらのリソースを通じてこのプロジェクトについてもっと学ぶことができます。

記事

Claude with MCPs replaced Cursor & Windsurf. How did that happen? - Model Context Protocol機能を備えたClaudeが開発者のワークフローをどのように変えているかを詳しく探る記事です。

ビデオ

Claude Desktop Commander Video Tutorial - コマンダーのセットアップと使用方法を見ることができます。

コミュニティ

ヘルプを得たり、フィードバックを共有したり、他のユーザーとつながったりするために、Discordサーバーに参加してください。

評判

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=UgyyBt6_ShdDX_rIOad4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=UgztdHvDMqTb9jiqnf54AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=UgyQFTmYLJ4VBwIlmql4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=Ugy4-exy166_Ma7TH-h4AaABAg

https://medium.com/@pharmx/you-sir-are-my-hero-62cff5836a3e

コントリビュート

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

コミュニティからのコントリビューションを歓迎します！バグを見つけた場合、機能要求がある場合、またはコードを貢献したい場合は、次のように支援できます。

バグを見つけた場合: github.com/wonderwhy-er/ClaudeComputerCommander/issues でイシューを開いてください。
機能アイデアがある場合: イシューセクションで機能要求を提出してください。
コードを貢献したい場合: リポジトリをフォークし、ブランチを作成して、プルリクエストを提出してください。
質問や議論がある場合: GitHub Discussionsタブで議論を開始してください。

すべてのコントリビューションは大きくても小さくても大いに感謝しています！

このツールがあなたのワークフローに役立つと思ったら、プロジェクトをサポートすることを検討してください。

📄 ライセンス

MIT

execute_command

タイムアウト時間内にターミナルコマンドを実行します。コマンドがタイムアウト時間内に完了しない場合、バックグラウンドで実行を続けます。

パラメータ

: *

説明

パラメータ

: *

説明

read_output

実行中のターミナルセッションから新しい出力を読み取ります。

パラメータ

: *

説明

force_terminate

実行中のターミナルセッションを強制終了します。

パラメータ

: *

説明

list_sessions

すべてのアクティブなターミナルセッションをリストアップします。

list_processes

すべての実行中のプロセスをリストアップします。PID、コマンド名、CPU使用率、およびメモリ使用率などのプロセス情報を返します。

kill_process

PIDを使用して実行中のプロセスを終了します。使用する際には注意が必要です。これにより、指定されたプロセスが強制終了されます。

パラメータ

: *

説明

block_command

コマンドをブラックリストに追加します。ブロックされると、そのコマンドは解除されるまで実行できなくなります。

パラメータ

: *

説明

unblock_command

コマンドをブラックリストから削除します。ブロックが解除されると、そのコマンドは正常に実行できます。

パラメータ

: *

説明

list_blocked_commands

現在ブロックされているすべてのコマンドをリストアップします。

read_file

ファイルシステムからファイルの完全な内容を読み取ります。さまざまなテキストエンコーディングを処理し、ファイルが読み取れない場合には詳細なエラーメッセージを提供します。許可されたディレクトリにのみ適用されます。

パラメータ

: *

説明

read_multiple_files

複数のファイルの内容を同時に読み取ります。各ファイルの内容はそのパスとともに返されます。単一のファイルの読み取り失敗は、全体の操作を停止させません。許可されたディレクトリにのみ適用されます。

パラメータ

: *

説明

write_file

ファイル内容を完全に置き換えます。大規模な変更（>ファイルサイズの20%）またはedit_blockが失敗した場合に最適です。使用する際には注意が必要です。これにより、既存のファイルが上書きされます。許可されたディレクトリにのみ適用されます。

パラメータ

: *

説明

パラメータ

: *

説明

create_directory

新しいディレクトリを作成するか、ディレクトリが存在することを確認します。一度の操作で複数のネストされたディレクトリを作成することができます。許可されたディレクトリにのみ適用されます。

パラメータ

: *

説明

list_directory

指定されたパス内のすべてのファイルとディレクトリの詳細なリストを取得します。結果は[FILE]と[DIR]のプレフィックスでファイルとディレクトリを区別します。許可されたディレクトリにのみ適用されます。

パラメータ

: *

説明

move_file

ファイルとディレクトリを移動またはリネームします。単一の操作でファイルをディレクトリ間で移動し、リネームすることができます。ソースとターゲットはどちらも許可されたディレクトリ内にある必要があります。

パラメータ

: *

説明

パラメータ

: *

説明

search_files

指定されたパターンに一致するファイルとディレクトリを再帰的に検索します。開始パスからすべてのサブディレクトリを検索します。許可されたディレクトリ内でのみ検索します。

パラメータ

: *

説明

パラメータ

: *

説明

get_file_info

ファイルまたはディレクトリの詳細なメタデータを取得します。サイズ、作成日時、最終更新日時、権限、およびタイプを含みます。許可されたディレクトリにのみ適用されます。

パラメータ

: *

説明

list_allowed_directories

このサーバーがアクセスを許可しているディレクトリのリストを返します。

edit_block

ファイルに対して正確なテキスト置換を行います。小規模な変更（<ファイルサイズの20%）に最適です。複数のブロックを使用して個別の変更を行うことができます。適用後、変更が検証されます。形式：ファイルパス、次に<<<<<<< SEARCH、検索する内容、=======、新しい内容、>>>>>>> REPLACE。

パラメータ

: *

説明