Desktop Commander MCP

简短版本。两个关键点：终端命令和基于差异的文件编辑。

目录

• 功能
• 安装
• 使用
• 处理长时间运行的命令
• 进行中的工作和待办事项
• 媒体链接
• 用户评价
• 贡献
• 许可

这是一个允许 Claude 桌面应用程序通过 Model Context Protocol (MCP) 在您的计算机上执行长时间运行的终端命令并管理进程的服务器 + 基于 MCP 文件系统服务器 构建，提供额外的搜索和替换文件编辑功能。

功能

• 执行带有输出流的终端命令
• 命令超时和支持后台执行
• 进程管理（列出和终止进程）
• 长时间运行命令的会话管理
• 完整的文件系统操作：
  • 读写文件
  • 创建/列出目录
  • 移动文件/目录
  • 搜索文件
  • 获取文件元数据
  • 代码编辑功能：
  • 对小改动进行精确的文本替换
  • 对大改动进行完全文件重写
  • 多文件支持
  • 基于模式的替换

安装

首先，请确保您已经下载并安装了 Claude 桌面应用程序，并且已经安装了 npm。

选项 1：通过 Smithery 安装

要通过 Smithery 自动为 Claude 桌面应用程序安装 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 的桌面应用程序
• 如果需要，将 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 Desktop中的本地服务器支持
• 完整的系统命令执行
• 进程管理
• 文件操作
• 代码编辑与搜索/替换块

作为探索Claude MCPs的一部分创建: 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 - 观看如何有效地设置和使用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=ly3bed99Dy9&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 上给它一个 ⭐ 星标！这有助于其他人发现该项目，并鼓励进一步的开发。

我们欢迎社区的贡献！无论你发现了 bug，有功能请求，还是想贡献代码，以下是你如何帮助的方式：

• 发现了 bug？ 在 github.com/wonderwhy-er/ClaudeComputerCommander/issues 上打开一个问题
• 有功能想法？ 在问题部分提交一个功能请求
• 想要贡献代码？ 叉出仓库，创建一个分支，并提交一个拉取请求
• 有问题或讨论？ 在 GitHub 的讨论标签中开始一个讨论

所有的贡献，无论大小，都非常感谢！

如果你认为这个工具对你的工作流程有价值，请考虑支持该项目。

许可证

MIT