Desktop Commander MCP 項目詳細介紹

項目概述

Desktop Commander MCP 是一個基於模型上下文協議 (MCP) 的伺服器工具，專為 Claude Desktop 應用程式設計。它通過 MCP 協議為 Claude 提供終端控制、檔案系統搜尋和差異化檔案編輯功能，將 Claude 轉變為一個強大的開發助手。

這個項目擴展了 MCP 檔案系統伺服器的功能，使開發者能夠通過 Claude 直接操作本地系統，執行命令，管理檔案，並進行程式碼編輯，超越了傳統 AI 編輯器的能力範圍。

核心功能特性

🖥️ 終端操作

• 命令執行: 執行終端命令並支持輸出流式傳輸
• 超時控制: 可配置的命令超時和後台執行支持
• 進程管理: 列出和終止運行中的進程
• 會話管理: 支持長時間運行命令的會話管理
• 多Shell支持: 支持 bash、zsh、powershell 等不同Shell環境

📁 檔案系統操作

• 檔案讀寫: 完整的檔案讀取和寫入功能
• 目錄管理: 創建、列出、移動檔案和目錄
• 檔案搜尋: 基於檔案名稱的搜尋功能
• 元數據獲取: 獲取檔案和目錄的詳細資訊
• 多檔案支持: 同時讀取多個檔案
• URL內容讀取: 支持從URL讀取文本和圖像內容

✏️ 程式碼編輯能力

• 精確替換: 針對小幅修改的外科手術式文本替換
• 完整重寫: 針對大幅更改的完整檔案重寫
• 多檔案支持: 同時編輯多個檔案
• 模式替換: 基於模式的文本替換
• 程式碼搜尋: 使用 vscode-ripgrep 進行遞迴程式碼或文本搜尋

⚙️ 伺服器配置管理

• 配置獲取/設置: 獲取和設置配置值
• 批量更新: 一次更新多個設置
• 動態配置: 無需重啟伺服器即可進行配置更改
• 安全控制: 支持阻止特定命令和限制目錄訪問

安裝方式

方式一：NPX 快速安裝（推薦）

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

方式二：macOS 自動化安裝

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

方式三：Smithery 安裝

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

方式四：手動構建安裝

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安裝時自動獲取最新版本

使用場景

開發場景

• 複雜程式碼庫的探索和理解
• 生成圖表和文檔
• 跨系統任務自動化
• 多項目同時工作
• 精確的程式碼修改

安全特性

• 可配置的阻止命令列表
• 允許目錄訪問控制
• 進程管理和監控
• 配置持久化和驗證