Desktop Commander MCP

Desktop Commander 是一个为 Claude 桌面应用程序设计的 MCP 服务器，提供两个核心功能：终端命令执行和基于差异的文件编辑。

安装

确保已安装 Claude 桌面应用程序 和 npm，然后选择以下安装方式之一：

推荐方式：通过 Smithery 安装

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

或通过 npx 直接安装

npx @wonderwhy-er/desktop-commander setup

安装后重启 Claude 桌面应用。

核心功能

终端命令

执行命令并获取输出：

execute_command: 运行终端命令，支持超时设置
read_output: 获取长时间运行命令的输出
list_sessions: 查看活动的命令会话
force_terminate: 停止运行中的命令

文件操作

基本文件系统功能：

read_file/write_file: 文件读写
list_directory: 查看目录内容
search_files: 基于模式查找文件
code_search: 代码内容搜索（基于ripgrep）

代码编辑

两种编辑模式：

1. 小改动：使用 edit_block 进行精确替换（适用于<20%文件的更改）

   filepath.ext
   <<<<<<< SEARCH
   现有代码
   =======
   新代码
   >>>>>>> REPLACE
   

2. 大改动：使用 write_file 完全重写文件（适用于>20%的更改）

处理长时间运行的命令

1. 使用 execute_command 启动命令（设置合适的超时）
2. 命令会在后台继续运行
3. 使用 read_output 和 PID 获取更多输出
4. 需要时用 force_terminate 结束命令

查找更多信息

• 官方网站：desktopcommander.app
• 视频教程：YouTube
• 加入讨论：Discord