wonderwhy-er DesktopCommanderMCP

好的，这是您要求的英文文章的中文翻译，已按照要求保留原文结构、代码块、技术术语，并输出为 Markdown 格式。

wonderwhy-er DesktopCommanderMCP

Desktop Commander MCP 使用 AI 搜索、更新、管理文件并运行终端命令。与代码和文本协作，运行进程，自动化任务，其能力远超其他 AI 编辑器——同时使用宿主客户端订阅，而非 API 令牌费用。🖥️

尝试 Desktop Commander 应用 (Beta 版) 想要更好的体验？Desktop Commander 应用为您提供 MCP 服务器的一切功能，外加：

使用任何 AI 模型 — Claude、GPT-4.5、Gemini 2.5，或您偏好的任何模型
实时查看文件更改 — AI 编辑文件时的可视化文件预览
添加自定义 MCP 和上下文 — 使用您自己的工具进行扩展，无需配置文件
即将推出 — 技能系统、听写、后台定时任务等

👉 [下载应用 (macOS & Windows)]

以下 MCP 服务器仍然可以与 Claude Desktop 及其他 MCP 客户端完美配合——该应用是为那些想要获得专用、精致体验的用户准备的。

您所有的 AI 开发工具，尽在一处。

Desktop Commander 将所有开发工具整合到一个聊天界面中。在您的计算机上执行长时间运行的终端命令，并通过模型上下文协议 (MCP) 管理进程。它构建在 MCP 文件系统服务器之上，以提供额外的搜索和替换文件编辑功能。

功能特性

远程 AI 控制 - 通过远程 MCP，从 ChatGPT、Claude 网页版及其他 AI 服务使用 Desktop Commander
文件预览 UI - 在 Claude Desktop 中提供可视化文件预览，包含渲染的 Markdown、内嵌图片、可展开内容、内置 Markdown 编辑器，以及快速“在文件夹中打开”访问
增强的终端命令，带有交互式进程控制
在内存中执行代码 (Python, Node.js, R)，无需保存文件
即时数据分析 - 只需提出要求即可分析 CSV/JSON/Excel 文件
原生 Excel 文件支持 - 无需外部工具即可读取、写入、编辑和搜索 Excel 文件 (.xlsx, .xls, .xlsm)
PDF 支持 - 通过文本提取读取 PDF，从 Markdown 创建新 PDF，修改现有 PDF
DOCX 支持 - 通过精确的 XML 编辑和 Markdown 到 DOCX 的转换，读取、创建、编辑和搜索 Word 文档 (.docx)
与正在运行的进程交互 (SSH, 数据库, 开发服务器)
执行终端命令并流式输出
命令超时和后台执行支持
进程管理 (列出和终止进程)
长时间运行命令的会话管理
进程输出分页 - 使用偏移量/长度控制读取终端输出，防止上下文溢出
服务器配置管理：获取/设置配置值，一次更新多个设置，无需重启服务器即可动态更改配置
完整的文件系统操作：读/写文件 (文本, Excel, PDF, DOCX)，创建/列出目录，递归列出目录（可配置深度，并针对大文件夹提供上下文溢出保护），移动文件/目录，搜索文件和内容（包括 Excel 内容），获取文件元数据
负偏移量文件读取：使用负偏移量值从文件末尾读取（类似 Unix tail 命令）
代码编辑能力：针对小改动进行精确文本替换，针对大改动进行完整文件重写，支持多文件，基于模式的替换，基于 vscode-ripgrep 的文件夹内递归代码或文本搜索
全面的审计日志：所有工具调用自动记录，日志轮转（10MB 大小限制），详细的时间戳和参数
安全加固：文件操作时防止符号链接遍历，命令黑名单及绕过保护，用于完全沙箱化的 Docker 隔离。详见 SECURITY.md

如何安装

在 Claude Desktop 中安装

Desktop Commander 为 Claude Desktop 提供多种安装方法。

📋 更新与卸载信息：选项 1、2、3、4 和 6 支持自动更新。选项 5 需要手动更新。详见下文。

选项 1：通过 npx 安装 ⭐ 自动更新 (需要 Node.js)

只需在终端中运行：

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

如需调试模式 (允许 Node.js 检查器连接)：

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

设置过程中的命令行选项：

--debug：为 Node.js 检查器启用调试模式
--no-onboarding：为新用户禁用引导提示

如果 Claude 正在运行，请重启。

✅ 自动更新：是 - 重启 Claude 时自动更新 🔄
手动更新：再次运行 setup 命令 🗑️
卸载：运行 npx @wonderwhy-er/desktop-commander@latest remove

选项 2：使用 bash 脚本安装器 (macOS) ⭐ 自动更新 (必要时安装 Node.js)

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

此脚本会自动处理所有依赖项和配置。

✅ 自动更新：是 🔄
手动更新：重新运行上述 bash 安装命令 🗑️
卸载：运行 npx @wonderwhy-er/desktop-commander@latest remove

选项 3：通过 Smithery 安装 ⭐ 自动更新 (需要 Node.js)

访问：https://smithery.ai/server/@wonderwhy-er/desktop-commander
如果尚未登录，请登录 Smithery
在右侧选择您的客户端 (Claude Desktop)
使用选择客户端后出现的密钥进行安装
重启 Claude Desktop
✅ 自动更新：是 - 重启 Claude 时自动更新 🔄
手动更新：访问 Smithery 页面并重新安装

选项 4：手动添加到 claude_desktop_config ⭐ 自动更新 (需要 Node.js)

将此条目添加到您的 claude_desktop_config.json 文件中：

在 Mac 上：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json
在 Linux 上：~/.config/Claude/claude_desktop_config.json

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

如果 Claude 正在运行，请重启。

✅ 自动更新：是 - 重启 Claude 时自动更新 🔄
手动更新：运行 setup 命令

wonderwhy-er DesktopCommanderMCP