### [Desktop Commander MCP：让 AI 直接掌控你的终端与文件系统](https://www.willai.cc/article/3623)

**Published:** 2026-07-10T12:05:37

**Author:** hiyoho

**Excerpt:** 一、项目简介 Desktop Commander MCP 是一个为 Claude、Cursor、VS Code、Claude Code 等 AI 编程客户端提供「终端控制 + 文件系统搜索 + 差异文件编辑」能力的 MCP（Model Co

![Desktop Commander MCP](https://admin.hiyoho.com/wp-content/uploads/2026/07/desktop-commander-og.png)

## 一、项目简介

**Desktop Commander MCP** 是一个为 Claude、Cursor、VS Code、Claude Code 等 AI 编程客户端提供「终端控制 + 文件系统搜索 + 差异文件编辑」能力的 MCP（Model Context Protocol）服务器。它让你的 AI 助手不再只会「动嘴」，而是能在你的本地电脑上真正「动手」——开终端、搜文件、改代码、跑命令、看结果，一条龙闭环。

项目由 wonderwhy-er 维护，目前 GitHub 收获 **6,700+ Stars**、882 Forks，采用 **MIT 协议**开源，底层用 TypeScript 实现，跨 Windows / macOS / Linux 全平台可用。

## 二、安装要求与过程

### 环境要求

-   **Node.js**（推荐 18+；或改用 Docker 方式，无需安装 Node）；
-   一个支持 MCP 的客户端：Claude Desktop / Cursor / VS Code / Claude Code / Codex / Gemini CLI / Windsurf 等；
-   **操作系统**：Windows、macOS、Linux 均可。

### 快速安装（以 Claude Desktop 为例，npx 自动更新）

```
npx @wonderwhy-er/desktop-commander@latest setup
```

或手动在 `claude_desktop_config.json` 中添加：

```
{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": ["-y", "@wonderwhy-er/desktop-commander@latest"]
    }
  }
}
```

### 其他客户端一句话安装

```
# Claude Code
claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

# Codex
codex mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

# Qwen Code
qwen mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest
```

不想装 Node？直接用 Docker 一键脚本（`install-docker.sh` / `install-docker.ps1`）启动；也可以通过 Smithery、Cursor 的 MCP 安装链接等图形化方式添加。

## 三、核心功能

1.  **增强型终端控制**：运行长时间命令、管理交互式进程（`start_process` / `interact_with_process` / `read_process_output` / `force_terminate`）、会话管理，并支持指定 bash / zsh 等 shell。
2.  **完整文件系统操作**：读 / 写 / 移动 / 递归列目录、按文件名与内容搜索（基于 vscode-ripgrep 的递归搜索）、读取文件元数据、负偏移 tail 读取超大日志。
3.  **差异文件编辑（edit\_block）**：精准 SEARCH/REPLACE 替换、模糊回退、字符级 diff、多文件与正则模式替换，像资深工程师一样做「外科手术式」修改，而不是整文件重写。
4.  **即时数据分析与办公文档**：在内存中直接跑 Python / Node / R 代码；原生读写 Excel（.xlsx/.xls/.xlsm）、PDF、DOCX；直接分析 CSV / JSON，数据不出本机。
5.  **企业级安全与可观测**：符号链接遍历防护、命令黑名单、Docker 隔离、全面审计日志（10MB 轮转）、动态配置无需重启。

## 四、典型使用场景

-   **大型代码库重构**：让 Claude 用 ripgrep 递归搜出所有调用某函数的地方，逐文件用 edit\_block 做差异修改。社区里有用户用它一次性修完 23 个文件、76 个错误的 Svelte 5 项目，速度远超传统 AI 编码体验。
-   **本地数据分析**：把 Downloads 里的 CSV 丢给 Agent，它直接在内存里跑 Python 做清洗、统计、画图，全程不离开本机，隐私可控。
-   **自动化日常办公**：自动按文件类型整理 Downloads、找出重复照片、把 Excel 报表转成图表或 Markdown，把重复的体力活交给 AI。

## 五、推荐理由

一句话总结：这是目前我用过「最像把 AI 变成真同事」的 MCP 工具。它不只是一个文件服务器，而是把「读代码 → 改代码 → 跑命令 → 看结果」的闭环搬进了对话框。

最香的是**差异编辑（edit\_block）**——AI 不再整文件重写，而是精准打补丁，token 消耗更低、上下文更稳，长时间对话也不容易「翻车」。配合 Claude Code / Cursor，几乎可以取代一部分 IDE 操作，Vibe Coding 体验拉满。

唯一要留意的是**权限边界**：它默认能跑任意终端命令，建议在配置里用 `allowedDirectories` 限定工作目录，并保持审计日志开启。整体来说，开源 MIT、跨平台、一行命令装好，强烈推荐给所有做 AI 编程的人。

## 六、下载地址

-   **官方网站**：[https://desktopcommander.app/](https://desktopcommander.app/)
-   **GitHub 仓库**：[https://github.com/wonderwhy-er/DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP)
-   **MCP 配置文档**：[https://desktopcommander.app/mcp/](https://desktopcommander.app/mcp/)
-   **Smithery 安装**：[smithery.ai/server/@wonderwhy-er/desktop-commander](https://smithery.ai/server/@wonderwhy-er/desktop-commander)

**Tags:** AI, AI Agent, AI开源项目, AI编程, Claude Code, CLI, MCP, MCP服务器, MIT许可, TypeScript

**Categories:** 开源项目

---