wonderwhy-er/DesktopCommanderMCP
This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities
這是什麼
Desktop Commander MCP 是一個用 TypeScript 寫成的 MCP 伺服器,目標是把 AI 聊天工具變成能操作本機開發環境的工作台。它讓 Claude Desktop、ChatGPT、Cursor、VS Code、Claude Code、Codex 等支援 MCP 的客戶端,可以搜尋與編輯檔案、執行終端機命令、管理長時間執行的 process,並處理 Excel、PDF、DOCX 等文件。README 特別說明它建在 MCP Filesystem Server 之上,再加上搜尋、取代、終端與 process 控制等能力;也就是說,它不是單純的「檔案讀寫工具」,而是把檔案系統、命令列與文件處理整合進同一個 AI 對話入口。
為什麼上榜
這個專案今天以 7,268 stars、單日新增 328 stars 登上日榜,熱度很合理:MCP 生態正在快速擴張,而 Desktop Commander 把最常見也最有感的需求——讓 AI 直接處理本機專案、跑命令、看輸出、改檔——包成可安裝的伺服器。它的亮點在於覆蓋面很廣:從互動式終端、背景執行、process 分頁讀取,到 Excel/PDF/DOCX 支援與 audit logging 都在 README 中列出。相較於只提供單一工具的 MCP,Desktop Commander 更像一組 AI 開發助理底座;但也因為能力接近本機操作員,README 同時強調 symlink traversal 防護、命令 blocklist、Docker isolation 與完整稽核紀錄,安全邊界會是使用時最需要留意的重點。
適合誰,可以拿來做什麼
它適合已經在使用 Claude Desktop、Cursor、VS Code Agent mode、Claude Code、Codex 或其他 MCP-compatible client 的開發者與 power user。典型用法包括:請 AI 搜尋專案、做小範圍精準替換、重寫檔案、分析 CSV/JSON/Excel、讀取或產生 PDF/DOCX、啟動開發伺服器並追蹤輸出,或管理 SSH、資料庫、長時間執行的命令。若你想降低 API token 成本,README 也提到可利用 host client subscriptions。上手門檻主要在 MCP 客戶端設定與本機權限管理;若想隔離環境,README 提供 Docker 安裝,適合不想讓工具直接碰到完整主機環境的人。
上手
README 提供多種安裝路徑。Claude Desktop 最直接的方式是透過 npx 安裝,需有 Node.js,安裝後重新啟動 Claude:
npx @wonderwhy-er/desktop-commander@latest setup
若想用除錯模式:
npx @wonderwhy-er/desktop-commander@latest setup --debug
其他 MCP 客戶端可加入標準設定:
{
"mcpServers": {
"desktop-commander": {
"command": "npx",
"args": ["-y", "@wonderwhy-er/desktop-commander@latest"]
}
}
}
README 也列出 macOS bash installer、Smithery、手動 Claude config、本地 checkout、以及 Docker sandbox 等選項;其中多數安裝方式支援自動更新。
README 重點摘要
- 提供 檔案搜尋/讀寫/移動/metadata、遞迴目錄列表、負 offset 讀檔,以及以 ripgrep 為基礎的內容搜尋。
- 終端功能支援輸出串流、timeout、背景執行、process list/kill、長時間命令 session 與輸出分頁,避免上下文爆量。
- 文件處理涵蓋 Excel、PDF、DOCX:README 明確列出讀寫、編輯、搜尋與 markdown 轉換等能力。
- 安全面包含自動 audit log、10MB log rotation、symlink traversal prevention、command blocklist,以及可選的 Docker isolation。
- 另有 Desktop Commander App beta,主打任意模型、即時檔案預覽、自訂 MCP/context;MCP server 仍可在 Claude Desktop 與其他客戶端使用。