デスクトップコマンダー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

進行中の作業とTODO

現在、以下の機能が開発中または計画中です。

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

メディア

以下のリソースを通じてこのプロジェクトの詳細を学んでください。

記事

MCPを搭載したClaudeがCursorとWindsurfに取って代わりました。これはどのようにして実現したのでしょうか？ - モデルコンテキストプロトコル機能を備えたClaudeが開発者のワークフローにどのような変化をもたらしているかを詳細に検証します。

ビデオ

Claude Desktop Commander ビデオチュートリアル- Commander を効果的にセットアップして使用する方法をご覧ください。

コミュニティ

サポートを受けたり、フィードバックを共有したり、他のユーザーとつながったりするには、 Discord サーバーに参加してください。

お客様の声

貢献

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

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

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

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

このツールがワークフローにとって価値があると思われる場合は、プロジェクトのサポートを検討してください。

ライセンス

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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.

Claude デスクトップアプリがコンピューター上でターミナルコマンドを実行し、モデルコンテキストプロトコルを介してファイルを編集できるようにするサーバー。コマンド実行、プロセス管理、高度なファイル操作などの機能を備えています。

Related MCP Servers

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
29,505
3,990
JavaScript
MIT License
Claude TypeScript MCP Servers
ukkz
A
security
A
license
A
quality
A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
Last updated -
2
19
TypeScript
MIT License
MCP Tools
ZbigniewTomanek
-
security
A
license
-
quality
A custom Model Context Protocol server that gives Claude Desktop and other LLMs access to file system operations and command execution capabilities through standardized tool interfaces.
Last updated -
23
Python
Apache 2.0
Notion MCP Server
tkc
-
security
F
license
-
quality
A filesystem Model Context Protocol server that provides Claude Desktop with capabilities to read, write, and manipulate files on your system.
Last updated -
7
TypeScript

View all related MCP servers

Desktop Commander MCP