wonderwhy-er/DesktopCommanderMCP —— 为Claude提供终端控制、文件搜索与差异编辑的MCP服务器

这是什么

Desktop Commander 是一个基于 Model Context Protocol (MCP) 的开源项目（主语言 TypeScript，GitHub ★6287），旨在将 AI 编辑器的能力从简单的代码补全扩展到完整的终端控制、文件系统和进程管理。它本质上是一个 MCP 服务器，允许 AI 客户端（如 Claude Desktop）直接在你的本地机器上执行命令、读写文件、管理长期运行的后台任务，并支持 Excel、PDF、DOCX 等非文本文件的直接操作。项目同时提供独立的 Desktop Commander App，兼容任意 AI 模型（如 Claude、GPT-4.5、Gemini 2.5），并增加了视觉文件预览、自定义 MCP 扩展、技能系统等增强体验。

解决的问题

• AI 编辑器能力边界窄：传统 AI 编辑器（如 Cursor、Copilot）只能处理代码文本，无法直接执行终端命令、操作数据库、管理进程或处理结构化文件。Desktop Commander 将终端、文件浏览器、进程管理整合到一个 AI 对话中，使 AI 能完成“编写脚本→运行测试→调试→重启服务”的完整闭环。
• 远程 AI 访问本地资源：通过 Remote MCP，用户可以从 ChatGPT web、Claude web 等在线服务安全地控制本地计算机执行任务，无需离开浏览器。
• 长期运行任务的托管：开发服务器、SSH 会话、数据库连接等长时间任务容易在 AI 对话中因超时而中断。Desktop Commander 提供会话管理和后台执行支持，允许 AI 持续监控或分页读取输出，防止上下文窗口溢出。
• 非技术文件的 AI 处理：Excel、PDF、DOCX 等格式在纯文本环境中难以编辑。Desktop Commander 原生支持读写、编辑、搜索这些文件，无需安装第三方工具或手动转换。

核心功能

• 增强终端命令执行：支持输出流式传输、命令超时控制、后台执行、进程输出分页读取（offset/length 控制），避免上下文溢出。
• 进程管理：列出所有运行进程、按 PID 或名称终止进程，与 SSH、数据库、开发服务器交互。
• 会话管理：为长时间运行的命令创建会话，AI 可随时检查状态或继续读取输出。
• 全面文件系统操作：读写文本文件、创建/列出/移动目录、递归目录列表（可配置深度以防溢出）、搜索文件和内容（包括 Excel 内搜索）、获取文件元数据、支持负偏移量读取（类似 tail 命令）。
• 代码编辑能力：外科手术式文本替换（精准替换小块代码）、完全重写大文件、多文件同步编辑、基于 vscode-ripgrep 的递归文本搜索和替换。
• 非文本文件原生支持：
  • Excel（.xlsx/.xls/.xlsm）：读取、写入、编辑、搜索，无需 Excel 安装。
  • PDF：文本提取、从 Markdown 创建新 PDF、修改现有 PDF。
  • DOCX：读取、创建、编辑、搜索，支持手术式 XML 编辑和 Markdown 转 DOCX。
• 审计日志：所有工具调用自动记录，日志轮转（10MB 限制），带时间戳和参数详情。
• 安全加固：符号链接遍历防护、命令黑名单与绕过保护、Docker 容器隔离（可选）。

亮点 / 与同类相比

• 超越传统 AI 编辑器的全栈自动化：大多数 AI 编辑器只能修改文件内容，Desktop Commander 允许 AI 直接执行 npm install、docker compose up、git push、数据库查询等，实现真正的端到端开发自动化。
• 进程输出分页与上下文管理：这是关键创新点——长命令的输出不会一次性冲爆 AI 上下文窗口，而是通过 offset/length 分页读取，AI 可以像读长文档一样逐步查看。同类工具（如 Claude Desktop 原生终端）缺乏此能力。
• 非文本文件的一站式处理：无需像其他方案那样先调用外部工具转成 CSV 或 JSON 再分析，直接操作 Excel/PDF/DOCX，减少步骤和数据泄露风险。
• 多安装方式与自动更新：提供 npx、bash 脚本、Smithery、手动配置、本地 git 克隆、Docker 六种安装方式，其中五种支持自动更新，降低维护成本。
• 独立 App 的扩展性：Desktop Commander App 不仅包含 MCP 服务器全部功能，还支持任意 AI 模型（不限于 Claude）、实时文件预览、自定义 MCP 工具（无需配置文件），未来还将加入技能系统和语音听写。这对追求体验一致性和模型自由度的用户极具吸引力。

适合谁用 / 上手

• 目标用户：
  • 使用 Claude Desktop、ChatGPT、Gemini 等 AI 客户端，希望 AI 能自动完成终端操作、文件管理、数据处理的全栈开发者。
  • 需要批量处理 Excel/PDF 数据的分析师或运维人员，希望用自然语言驱动文件操作。
  • 习惯 Docker 隔离环境的用户，通过 Docker 安装无需本地 Node.js 环境，且拥有沙箱安全。
  • 对 AI 工作流有长期后台任务（如持续监控日志、定时脚本）需求的高级用户。
• 快速上手：推荐方式（需 Node.js）——在终端中执行 npx @wonderwhy-er/desktop-commander@latest setup，重启 Claude Desktop 即可。安装过程会引导配置，无需手动编辑 config 文件。Docker 用户只需运行项目提供的 shell 或 PowerShell 脚本，自动拉取镜像并配置。安装后即可在 Claude 对话中通过自然语言指令执行 Run terminal command…、Read file…、Edit Excel… 等操作。详细用法参见项目 README 中的 Usage 章节。