Claudedesktopcommander

🚀 桌面指揮官MCP

桌面指揮官MCP是一個服務器，允許Claude桌面應用程序在你的計算機上執行長時間運行的終端命令，並通過模型上下文協議（MCP）管理進程。它基於 MCP文件系統服務器 構建，提供額外的搜索和替換文件編輯功能。

🚀 快速開始

此服務器允許Claude桌面應用程序在你的計算機上執行長時間運行的終端命令，並通過模型上下文協議（MCP）管理進程。它基於 MCP文件系統服務器 構建，以提供額外的搜索和替換文件編輯功能。

✨ 主要特性

• 終端命令執行：支持輸出流的終端命令執行，具備命令超時和後臺執行功能。
• 進程管理：可列出和終止進程，支持長時間運行命令的會話管理。
• 文件系統操作：涵蓋文件讀寫、目錄創建與列出、文件/目錄移動、文件搜索、文件元數據獲取等完整操作。
• 代碼編輯能力：支持小範圍的精確文本替換和大範圍的文件重寫，支持多文件和基於模式的替換。

📦 安裝指南

首先，確保你已下載並安裝 Claude桌面應用程序，並且已安裝 npm。

選項1：通過Smithery安裝

要通過 Smithery 自動為Claude桌面應用程序安裝桌面指揮官，請運行以下命令：

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桌面應用程序
• 必要時將MCP服務器添加到Claude的配置中

💻 使用示例

基礎用法

服務器提供以下工具類別：

終端工具

• 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. 使用 read_output 和PID獲取新的輸出。
4. 如果需要，使用 force_terminate 停止命令。

📚 詳細文檔

模型上下文協議集成

本項目擴展了MCP文件系統服務器，以實現以下功能：

• Claude桌面應用程序的本地服務器支持
• 完整的系統命令執行
• 進程管理
• 文件操作
• 使用搜索/替換塊進行代碼編輯

此項目是探索Claude MCP的一部分：https://youtube.com/live/TlbjFDbl5Us

開發進度和待辦事項

以下功能正在開發或計劃中：

• 更強大的代碼搜索 (開發中) - 增強代碼探索，提供上下文感知的搜索結果。
• 更完善的配置 (開發中) - 改進允許路徑、命令和shell環境的設置。
• Windows環境修復 (開發中) - 解決特定於Windows平臺的問題。
• Linux兼容性增強 (開發中) - 提高與各種Linux發行版的兼容性。
• WSL支持 - 支持Windows子系統Linux。
• SSH支持 - 支持遠程服務器命令執行。
• 安裝故障排除指南 - 提供全面的安裝問題幫助。

媒體鏈接

通過以下資源瞭解更多關於本項目的信息：

• 文章：Claude with MCPs replaced Cursor & Windsurf. How did that happen? - 詳細探討了具備模型上下文協議功能的Claude如何改變開發者的工作流程。
• 視頻：Claude Desktop Commander Video Tutorial - 觀看如何有效設置和使用指揮官。
• 社區：加入我們的 Discord服務器 以獲取幫助、分享反饋並與其他用戶交流。

用戶評價

• 用戶評價1
• 用戶評價2
• 用戶評價3
• 用戶評價4
• 用戶評價5

貢獻指南

如果你覺得這個項目有用，請在GitHub上給它點個 ⭐ 星星！這有助於其他人發現該項目並鼓勵進一步開發。

我們歡迎社區的貢獻！無論你是發現了一個bug、有一個功能請求，還是想貢獻代碼，都可以通過以下方式提供幫助：

• 發現bug：在 github.com/wonderwhy-er/ClaudeComputerCommander/issues 上提交一個問題。
• 有功能想法：在問題部分提交一個功能請求。
• 想貢獻代碼：分叉倉庫，創建一個分支，並提交一個拉取請求。
• 有問題或討論：在GitHub討論標籤中發起一個討論。

所有貢獻，無論大小，都非常感謝！

如果你覺得這個工具對你的工作流程有價值，請考慮 支持該項目。

📄 許可證

本項目採用MIT許可證。