wonderwhy-er/DesktopCommanderMCP
AI 工程为 AI 客户端提供终端控制、文件系统搜索和 diff 式文件编辑能力的本地 MCP 服务器。
Desktop Commander MCP
Desktop Commander 是一个 Model Context Protocol(MCP)服务器,为 Claude Desktop、Claude Code、Cursor、Windsurf、VS Code/Copilot、Codex、JetBrains、Gemini CLI 等 AI 客户端补上终端控制、完整的文件系统操作和基于 search/replace 的代码编辑能力。它基于 MCP Filesystem Server 扩展而来,增加了进程管理、在内存中执行代码,以及对 Excel、PDF、DOCX 文件的直接读写 README。
它面向希望让 AI 助手跨越整个操作系统、而不局限在单个 IDE 内的开发者:运行长时间驻留的 shell、SSH 会话或数据库客户端,浏览大型代码库,精细修改文件,并在对话中直接分析数据文件。服务器以当前用户权限在本地运行;通过 npx 或 Smithery 安装时,使用宿主客户端的订阅额度,而不是额外的 API 计费。
快速开始(Claude Desktop)
前提:已安装 Node.js。运行安装命令后重启 Claude Desktop:
npx @wonderwhy-er/desktop-commander@latest setup
该命令会把服务器写入 Claude 的 claude_desktop_config.json,并在重启 Claude 时自动更新。卸载时运行 npx @wonderwhy-er/desktop-commander@latest remove。其他安装方式包括 macOS 脚本安装、Smithery、手动 JSON 配置、本地检出和 Docker;Windows 上可用 npx 方式,或在 %APPDATA%\Claude\claude_desktop_config.json 中手动添加入口 README。其他客户端使用同一段标准 JSON 配置,例如 Claude Code 可执行 claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest README。
连接后可以直接提问,例如「分析 sales.csv 并列出主要客户」(Claude 在内存中运行 Python),或「启动 Node.js 并测试这个 API」。服务器提供 start_process、interact_with_process、read_process_output、read_file、write_file 以及基于 SEARCH/REPLACE 块格式的 edit_block 等工具 README。ChatGPT、Claude 网页版等远程客户端可以借助 npx @wonderwhy-er/desktop-commander@latest remote 启动本地设备,在本机执行命令,远程设备另有独立配置说明 README。
使用约束与安全
- 不是沙箱。
allowedDirectories只限制文件操作,终端命令仍可访问目录之外的路径,且可通过符号链接、命令替换或绝对路径绕过拦截。需要生产级隔离时使用 Docker 安装方式 SECURITY.md。 - 本地日志可能含敏感信息。 每次工具调用的参数会不经脱敏写入本地
claude_tool_call.log(10 MB 轮转),近期调用记录保存在tool-history.jsonl(约保留最新 4 MiB)。这些是本地文件,不是服务端审计记录。 - 可选遥测。 默认开启匿名遥测,不包含文件内容、路径或命令参数;可通过配置或让 Claude 关闭遥测 PRIVACY.md。
- 改配置时另开一个对话,因为 Claude 在遇到文件访问限制时可能尝试放宽
allowedDirectories等设置。 - 平台要求。 多数安装方式需要 Node.js,Docker 方式需要 Docker Desktop。许可证为 MIT。
HotRepo 点评
2026-07-08 至 2026-07-13 的全部语言日榜快照显示,该项目 Star 数从 6,312 升至 8,123,其中 2026-07-11 单日新增 900,是同期 MCP 工具里增长较猛的一档。到 2026-11-19,Star 数达到 10,362,并在 JavaScript 日榜上排到第 3,说明这轮增长不是一次性脉冲。README 覆盖的客户端范围较广,并明确写出了安全边界,看起来是相对完整的 MCP 集成而非薄封装;读者在评估时,需要在「全系统终端访问的便利」与「默认不提供沙箱」之间做权衡。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。