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

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

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

特徴

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

インストール

まず、 Claude デスクトップアプリをダウンロードしてインストールし、 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タイムアウト後に初期出力で戻ります
コマンドはバックグラウンドで継続されます
新しい出力を取得するには、PID を指定したread_output使用します。
必要に応じてforce_terminateを使用して停止します

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

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

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

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

貢献

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

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

バグを発見しましたか？ github.com/wonderwhy-er/ClaudeComputerCommander/issuesで問題を報告してください。
**機能に関するアイデアをお持ちですか？**問題セクションから機能リクエストを送信してください。
**コードを投稿したいですか？**リポジトリをフォークしてブランチを作成し、プルリクエストを送信してください。
質問や議論はありますか？ GitHubのディスカッションタブで議論を始めてください。

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

ライセンス

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

Claude がコンピューター上でターミナルコマンドを実行し、diff ベースの置換による外科的コード編集などのファイルシステム操作を実行できるようにします。

Related MCP Servers

Claude Dev Server
arben-adm
-
security
A
license
-
quality
The Claude Dev Server enables direct interaction with the file system within a specified workspace, allowing users to perform file and directory operations and implement code artifacts in software development using natural language commands.
Last updated -
2
Python
MIT License
MCP Code Analyzer
emiryasar
-
security
A
license
-
quality
A comprehensive code analysis and management tool that integrates with Claude Desktop to analyze code at project and file levels, helping adapt changes to projects intelligently.
Last updated -
37
Python
MIT License
Claude Desktop Commander MCP
wonderwhy-er
A
security
A
license
A
quality
Allows Claude desktop app to execute terminal commands and edit files on your computer through MCP, with features including command execution, process management, and diff-based file editing.
Last updated -
19
38,005
3,990
JavaScript
MIT License
MCP Server for FTP Access
alxspiker
A
security
A
license
A
quality
Enables Claude to interact with FTP servers through natural language commands, allowing users to list directories, download/upload files, create directories, and delete files/directories on FTP servers.
Last updated -
6
8
JavaScript
MIT License

View all related MCP servers

Claude Desktop Commander MCP