搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

wonderwhy-er/DesktopCommanderMCP

AI 工程

为 AI 客户端提供终端控制、文件系统搜索和 diff 式文件编辑能力的本地 MCP 服务器。

10,366
1,298
JavaScript
MIT
创建于 1 年前

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 生成,更新于 ,以项目官方文档为准。

Hacker News 讨论

Desktop Commander MCP
▲ 2 · 0 条评论 · 2026年6月23日
Recomment a MCP for Claude Desktop
▲ 1 · 0 条评论 · 2025年5月2日

相关推荐

  1. oraios/serena通过 MCP 为编程 Agent 提供符号级检索、重构和编辑等 IDE 能力,覆盖 40 多种语言。Python30,969
  2. shanselman/sandbox-mcp通过 CLI 或 MCP 自动启动一次性 Windows Sandbox,完成应用测试、UI 自动化、安装包对比和未知文件行为分析。JavaScript108
  3. Graphicle-AI/graphicle把代码图谱和项目记忆装进一个本地程序,通过 MCP 给编程 Agent 返回带出处的片段。Rust356