Desktop Commander MCP

基本能力

产品定位

Desktop Commander MCP 是一个增强 Claude 桌面应用功能的工具，使其能够执行终端命令、管理文件系统、进行代码编辑和搜索，从而提升开发效率和自动化任务处理能力。

核心功能

• 终端命令执行：支持执行终端命令并实时流式输出，支持超时和后台执行。
• 进程管理：列出和终止系统进程。
• 文件系统操作：读写文件、创建/列出目录、移动文件、搜索文件、获取文件元数据。
• 代码编辑：支持精确的文本替换和完整的文件重写。
• 代码搜索：基于 ripgrep 的递归文本和代码搜索。
• URL 支持：从 URL 读取内容，支持文本和图像。

适用场景

• 代码编辑与重构：通过精确的搜索和替换功能进行代码修改。
• 文件管理：自动化文件操作，如批量重命名、移动或搜索文件。
• 终端命令执行：运行复杂的终端命令并实时查看输出。
• 代码库探索：快速搜索和理解大型代码库。

工具列表

• 终端工具：execute_command, read_output, force_terminate, list_sessions, list_processes, kill_process, block_command, unblock_command。
• 文件系统工具：read_file, write_file, create_directory, list_directory, move_file, search_files, get_file_info, search_code。
• 编辑工具：edit_block, write_file。

常见问题解答

• 什么是 Claude Desktop Commander？：它是一个 MCP 工具，使 Claude 桌面应用能够访问文件系统和终端。
• 与 Cursor/Windsurf 的区别？：提供更全面的系统级操作，而不仅限于 IDE 环境。
• 是否需要支付 API 费用？：不需要，仅需 Claude Pro 订阅。
• 如何获取帮助？：可通过 Discord、GitHub issues 或网站 FAQ 获取支持。

使用教程

使用依赖

• 安装 Claude 桌面应用。
• 确保已安装 npm。

安装教程

1. 通过 npx 安装： bash npx @wonderwhy-er/desktop-commander@latest setup 调试模式： bash npx @wonderwhy-er/desktop-commander@latest setup --debug

2. 使用 bash 脚本安装（macOS）： bash curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

3. 通过 Smithery 安装： bash npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

4. 手动添加到 claude_desktop_config： 修改 claude_desktop_config.json 文件，添加以下内容： json { "mcpServers": { "desktop-commander": { "command": "npx", "args": [ "-y", "@wonderwhy-er/desktop-commander" ] } } }

5. 本地克隆并构建： bash git clone https://github.com/wonderwhy-er/ClaudeComputerCommander.git cd ClaudeComputerCommander npm run setup

调试方式

1. 安装调试模式： bash npx @wonderwhy-er/desktop-commander@latest setup --debug 或 bash npm run setup:debug
2. 连接调试器：
3. 在 Chrome 中访问 chrome://inspect。
4. 在 VS Code 中使用 "Attach to Node Process" 配置。
5. 调试端口：9229。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。