Desktop Commander MCP

by MrGNSS
Verified
MIT License
12,588
  • Linux
  • Apple

Integrations

  • Provides a way for users to support the project financially through the Buy Me A Coffee platform.

  • Allows users to join a Discord server for getting help, sharing feedback, and connecting with other users of the Desktop Commander MCP.

  • Facilitates project contribution, issue reporting, and discussions through GitHub's platform.

デスクトップコマンダー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: 現地でチェックアウト

  1. クローンとビルド:
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

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

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

  1. execute_commandタイムアウト後に初期出力で戻ります
  2. コマンドはバックグラウンドで継続されます
  3. 新しい出力を取得するには、PID を指定したread_output使用します。
  4. 必要に応じて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 サーバーに参加してください。

お客様の声

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のディスカッションタブで議論を始めてください。

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

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

ライセンス

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

-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Table of Contents
    1. Features
      1. Installation
        1. Option 1: Installing via Smithery
        2. Option 2: Install trough npx
        3. Option 3: Add to claude_desktop_config by hand
        4. Option 4: Checkout locally
      2. Usage
        1. Terminal Tools
        2. Filesystem Tools
        3. Edit Tools
      3. Handling Long-Running Commands
        1. Model Context Protocol Integration
          1. Work in Progress and TODOs
            1. Media
              1. Article
              2. Video
              3. Community
            2. Testimonials
              1. Contributing
                1. License
                  ID: 7twwxtnbgd