桌面指挥官 MCP

使用 AI 搜索、更新、管理文件并运行终端命令

处理代码与文本、运行进程并自动化任务，远超其他 AI 编辑器——同时采用主机客户端订阅模式，而非 API Token 费用。

👋 我们正在招聘——欢迎加入我们：https://desktopcommander.app/careers/

🖥️ 试用桌面指挥官应用（Beta 版）

想要更佳体验吗？ 桌面指挥官应用为您提供 MCP 服务器的所有功能，并额外具备：

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

👉 下载应用（macOS & Windows）

下方的 MCP 服务器仍可与 Claude Desktop 及其他 MCP 客户端完美配合——而这款应用则专为追求专注、精致体验的用户打造。

目录

• 功能
• 安装方法
• 入门指南
• 使用说明
• 处理长时间运行的命令
• 开发进展与待办事项
• 赞助商与支持者
• 官网
• 媒体
• 用户评价
• 常见问题
• 贡献
• 许可证

将您的所有 AI 开发工具集中于一处。
桌面指挥官将所有开发工具整合到一个聊天界面中。
在您的电脑上执行长时间运行的终端命令，并通过模型上下文协议（MCP）管理进程。基于 MCP 文件系统服务器 构建，提供额外的搜索与替换文件编辑功能。

功能

• 远程 AI 控制 —— 通过 Remote MCP 从 ChatGPT、Claude Web 等 AI 服务中使用桌面指挥官
• 文件预览 UI —— 在 Claude Desktop 中提供可视化文件预览，支持渲染 Markdown、内嵌图片、内容展开以及快速“在文件夹中打开”功能
• 增强的终端命令与交互式进程控制
• 在内存中执行代码（Python、Node.js、R），无需保存文件
• 即时数据分析——只需提问即可分析 CSV/JSON/Excel 文件
• 原生 Excel 文件支持 —— 无需外部工具即可读取、写入、编辑和搜索 Excel 文件（.xlsx、.xls、.xlsm）
• PDF 支持 —— 支持文本提取的 PDF 阅读、从 Markdown 创建新 PDF、修改现有 PDF
• DOCX 支持 —— 支持读取、创建、编辑和搜索 Word 文档（.docx），具备精细的 XML 编辑功能及 Markdown 转 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 需手动更新。详情请见下文。

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

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

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

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

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)

iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'))

{
  "mcpServers": {
    "desktop-commander-in-docker": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/desktop-commander:latest"]
    }
  }
}

{
  "mcpServers": {
    "desktop-commander-in-docker": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/username/Desktop:/mnt/desktop",
        "-v", "/Users/username/Documents:/mnt/documents",
        "mcp/desktop-commander:latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "desktop-commander-in-docker": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "dc-system:/usr",
        "-v", "dc-home:/root", 
        "-v", "dc-workspace:/workspace",
        "-v", "dc-packages:/var",
        "-v", "/Users/username/Projects:/mnt/Projects",
        "-v", "/Users/username/Downloads:/mnt/Downloads",
        "mcp/desktop-commander:latest"
      ]
    }
  }
}

# 查看状态
bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --status

# 重置所有持久化数据
bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --reset

# 查看状态
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Status

# 重置所有数据
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Reset

# 显示帮助
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Help

bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --reset && bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)

在其他客户端中安装

Desktop Commander 可与任何兼容 MCP 的客户端配合使用。标准的 JSON 配置如下：

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

将此配置添加到您的客户端的 MCP 配置文件中，位置如下：

claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

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

[mcp_servers.desktop-commander]
command = "npx"
args = ["-y", "@wonderwhy-er/desktop-commander@latest"]

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

qwen mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

更新与卸载 Desktop Commander

自动更新（选项 1、2、3、4 和 6）

选项 1（npx）、选项 2（bash 安装程序）、选项 3（Smithery）、选项 4（手动配置）以及选项 6（Docker） 在您重启 Claude 时会自动更新到最新版本。无需手动干预。

手动更新（选项 5）

• 选项 5（本地检出）： cd DesktopCommanderMCP && git pull && npm run setup

卸载 Desktop Commander

🤖 自动卸载（推荐）

彻底移除 Desktop Commander 的最简单方法：

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

此自动卸载工具将：

• ✅ 从 Claude 的 MCP 服务器配置中移除 Desktop Commander
• ✅ 在进行更改前为您的 Claude 配置创建备份
• ✅ 提供完整卸载包的指导
• ✅ 如遇问题，可从备份中恢复

🔧 手动卸载

如果自动卸载工具无法正常工作，或您更倾向于手动移除：

从 Claude 配置中移除

1. 找到您的 Claude Desktop 配置文件：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json
   • Linux： ~/.config/Claude/claude_desktop_config.json

2. 编辑配置文件：

   • 使用文本编辑器打开该文件
   • 在 "mcpServers" 部分查找并删除 "desktop-commander" 条目
   • 保存文件

   示例——移除以下部分：

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

关闭并重新启动 Claude Desktop，以完成移除。

🆘 故障排除

如果自动卸载失败：

• 请使用手动卸载作为备用方案

如果卸载后 Claude 无法启动：

• 恢复由卸载工具创建的备份配置文件
• 或者手动修复您的 claude_desktop_config.json 文件中的 JSON 语法

需要帮助吗？

• 加入我们的 Discord 社区：https://discord.com/invite/kQ27sNnZr7

入门指南

一旦安装好 Desktop Commander 并重启 Claude Desktop，您就可以开始大幅提升您的 Claude 使用体验了！

🚀 新用户引导

Desktop Commander 内置智能引导功能，帮助您发现各种可能性：

针对新用户： 当您刚开始使用（成功执行命令少于 10 次）时，Claude 会在您成功使用 Desktop Commander 后，自动提供实用的入门指导和教程。

随时请求帮助： 您可以随时通过说出以下话语来获得引导帮助：

• “帮我开始使用 Desktop Commander”
• “给我看 Desktop Commander 的示例”
• “我可以用 Desktop Commander 做些什么？”

随后，Claude 将为您展示适合初学者的教程和示例，包括：

• 📁 自动整理您的下载文件夹
• 📊 使用 Python 分析 CSV/Excel 文件
• ⚙️ 设置 GitHub Actions CI/CD
• 🔍 探索并理解代码库
• 🤖 运行交互式开发环境

使用说明

该服务器提供了一套全面的工具，按多个类别组织：

可用工具

快速示例

数据分析：

“分析 sales.csv 并显示顶级客户” → Claude 在内存中运行 Python 代码

远程访问：

“SSH 到我的服务器并检查磁盘空间” → Claude 维持 SSH 会话

开发：

“启动 Node.js 并测试这个 API” → Claude 运行交互式 Node 会话

工具使用示例

搜索/替换块格式：

filepath.ext
<<<<<<< SEARCH
要查找的内容
=======
新内容
>>>>>>> REPLACE

示例：

src/main.js
<<<<<<< SEARCH
console.log("旧消息");
=======
console.log("新消息");
>>>>>>> REPLACE

增强的编辑块功能

edit_block 工具包含多项增强功能，以提升可靠性：

1. 改进提示：工具说明现在强调进行多次小而集中的修改，而非一次性进行大改动。
2. 模糊搜索回退：当精确匹配失败时，系统会执行模糊搜索并提供详细反馈。
3. 字符级差异显示：使用 {-removed-}{+added+} 格式精确展示不同之处。
4. 多处替换支持：可通过 expected_replacements 参数一次性替换多个实例。
5. 全面日志记录：所有模糊搜索都会被记录下来，便于分析与调试。

当搜索失败时，您将看到关于找到的最接近匹配的详细信息，包括相似度百分比、执行时间以及字符差异。所有这些细节都会自动记录下来，以便后续使用模糊搜索日志工具进行分析。

Docker 支持

🐳 隔离环境使用

Desktop Commander 可以在 Docker 容器中运行，实现与宿主机系统的完全隔离，从而确保您的计算机零风险。这非常适合用于测试、开发，或需要完全沙盒化环境的场景。

安装说明

1. 安装适用于 Windows/Mac 的 Docker

   • 从 docker.com 下载并安装 Docker Desktop。

2. 获取 Desktop Commander 的 Docker 配置

   • 访问：https://hub.docker.com/mcp/server/desktop-commander/manual
   • 选项 A：使用提供的终端命令进行自动化设置。
   • 选项 B：点击“独立”以获取配置 JSON，并手动将其添加到您的 Claude Desktop 配置中。

3. 挂载本地文件夹（即将推出）

   • 关于如何将本地目录挂载到 Docker 容器中的说明将很快发布。
   • 这样您就可以在保持完全隔离的同时处理自己的文件。

使用 Docker 的优势

• 完全隔离 与宿主机系统。
• 一致的环境 在不同机器上保持一致。
• 易于清理——完成任务后只需删除容器即可。
• 非常适合测试 新功能或新配置。

URL 支持

• read_file 现在既可以读取本地文件，也可以从 URL 获取内容。
• 示例：使用 isUrl: true 参数调用 read_file 以读取网络资源。
• 同时支持远程来源的文本和图像内容。
• 图像（无论是本地还是来自 URL）都会在 Claude 的界面中以可视化方式显示，而不是作为文本呈现。
• Claude 能够查看并分析实际的图像内容。
• 默认对 URL 请求设置 30 秒超时。

模糊搜索日志分析（npm 脚本）

模糊搜索日志系统包含便捷的 npm 脚本，可在 MCP 环境外部对日志进行分析：

# 查看最近的模糊搜索日志
npm run logs:view -- --count 20

# 分析模式与性能
npm run logs:analyze -- --threshold 0.8

# 将日志导出为 CSV 或 JSON
npm run logs:export -- --format json --output analysis.json

# 清除所有日志（需确认）
npm run logs:clear

有关这些脚本的详细文档，请参阅 scripts/README.md。

模糊搜索日志

Desktop Commander 包含针对 edit_block 工具中模糊搜索操作的全面日志记录功能。当无法找到精确匹配时，系统会执行模糊搜索，并记录详细信息以便分析。

日志记录的内容

每次模糊搜索操作都会记录：

• 搜索与找到的文本：您要查找的文本与实际找到的文本对比。
• 相似度分数：匹配的接近程度（0–100%）。
• 执行时间：搜索耗时。
• 字符差异：详细显示具体不同的地方。
• 文件元数据：扩展名、搜索/找到文本的长度。
• 字符编码：导致差异的具体字符编码。

日志保存位置

日志会自动保存至：

• macOS/Linux：~/.claude-server-commander-logs/fuzzy-search.log
• Windows：%USERPROFILE%\.claude-server-commander-logs\fuzzy-search.log

您能从中了解到什么

模糊搜索日志可以帮助您理解：

1. 精确匹配为何失败：常见问题如空格差异、行尾符或字符编码问题。
2. 性能模式：搜索复杂度如何影响执行时间。
3. 文件类型问题：哪些文件扩展名常出现匹配问题。
4. 字符编码问题：哪些特定字符编码会导致差异。

审计日志

Desktop Commander 现在包含对所有工具调用的全面日志记录功能：

日志记录的内容

• 每次工具调用都会记录时间戳、工具名称及参数（已进行隐私保护处理）。
• 当日志达到 10MB 时会自动轮转。

日志保存位置

日志保存至：

• macOS/Linux：~/.claude-server-commander/claude_tool_call.log
• Windows：%USERPROFILE%\.claude-server-commander\claude_tool_call.log

此审计追踪有助于调试、安全监控以及了解 Claude 如何与您的系统交互。

处理长时间运行的命令

对于可能需要较长时间才能完成的命令：

配置管理

⚠️ 重要安全警告

有关全面的安全信息及漏洞报告：请参阅 SECURITY.md

1. 已知的安全限制：目录限制与命令阻断可通过多种方式绕过，包括符号链接、命令替换、绝对路径以及代码执行等。

2. 始终在单独的聊天窗口中更改配置，不要与实际工作同时进行。Claude 有时可能会尝试修改配置设置（如 allowedDirectories），尤其是在遇到文件系统访问限制时。

3. 目前 allowedDirectories 设置仅限制文件系统操作，并不限制终端命令。终端命令仍可访问允许目录之外的文件。

4. 出于生产环境的安全考虑：请使用 Docker 安装，该方法可实现与宿主机系统的完全隔离。

配置工具

您可以使用提供的工具来管理服务器配置：

// 获取整个配置
get_config({})

// 设置特定的配置值
set_config_value({ "key": "defaultShell", "value": "/bin/zsh" })

// 通过多次调用设置多个配置值
set_config_value({ "key": "defaultShell", "value": "/bin/bash" })
set_config_value({ "key": "allowedDirectories", "value": ["/Users/username/projects"] })

配置会保存到服务器工作目录下的 config.json 文件中，并在服务器重启后仍然有效。

关于 fileWriteLineLimit 的说明

fileWriteLineLimit 设置控制单次 write_file 操作可以写入的最大行数（默认值为 50 行）。设置这一限制有以下几个重要原因：

为什么需要设置这个限制：

• AI 在使用 Token 方面较为浪费：AI 可能不会对文件进行两次小规模的修改，而是选择直接重写整个文件。我们希望通过限制每次操作的行数，促使 AI 以更小的改动方式完成任务，从而节省时间和 Token。
• Claude 的消息长度限制：单条消息存在长度限制，且点击“继续”按钮并不能真正解决问题。我们希望 AI 能够以更小的块状方式处理任务，这样当达到消息长度限制时，已经成功处理的部分不会丢失——只需从上一个块重新开始即可。

如何设置该限制：

// 如果需要，可以将其设置为上千行
set_config_value({ "key": "fileWriteLineLimit", "value": 1000 })

// 或者保持较小的值以强制更高效的行为
set_config_value({ "key": "fileWriteLineLimit", "value": 25 })

最大值：您可以根据需要将其设置为上千行——技术上没有任何限制。

最佳实践：

• 建议保持默认值（50 行），以鼓励 AI 更高效地工作并避免 Token 浪费。
• 当超过限制时，系统会自动提示分块处理。
• 分块越小，当 Claude 达到消息长度限制时，丢失的工作就越少。

最佳实践

1. 创建专门的聊天用于配置更改：所有配置更改都应在同一个聊天中完成，然后开启一个新的聊天进行实际工作。

2. 谨慎设置空的 allowedDirectories：如果将此设置为一个空数组 ([])，则文件操作将获得对整个文件系统的访问权限。

3. 使用具体的路径：不要使用像 / 这样的宽泛路径，而应明确指定您希望访问的具体目录。

4. 更改后务必验证配置：使用 get_config({}) 确认您的更改已正确应用。

命令行选项

Desktop Commander 支持多种命令行选项，用于自定义行为：

禁用引导功能

默认情况下，Desktop Commander 会向新用户（即工具调用次数少于 10 次的用户）显示有用的引导提示。您可以禁用此功能：

# 禁用本次会话的引导
node dist/index.js --no-onboarding

# 或者使用 npm 脚本
npm run start:no-onboarding

# 对于 npx 安装，修改您的 claude_desktop_config.json：
{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander@latest",
        "--no-onboarding"
      ]
    }
  }
}

自动禁用引导的情况：

• 当 MCP 客户端名称被设置为 “desktop-commander” 时；
• 当使用 --no-onboarding 标志时；
• 当用户已经使用过引导提示或进行了 10 次以上的工具调用后。

调试信息： 服务器会在引导被禁用时记录日志：“通过 --no-onboarding 标志禁用了引导”。

使用不同的 Shell

您可以指定用于执行命令的 Shell：

// 使用默认 Shell（bash 或系统默认）
execute_command({ "command": "echo $SHELL" })

// 特别使用 zsh
execute_command({ "command": "echo $SHELL", "shell": "/bin/zsh" })

// 特别使用 bash
execute_command({ "command": "echo $SHELL", "shell": "/bin/bash" })

这使您能够利用特定 Shell 的功能，或在不同命令之间保持一致的环境。

1. execute_command 在超时后返回初始输出；
2. 命令在后台继续执行；
3. 使用 read_output 并提供 PID 来获取新的输出；
4. 如有必要，使用 force_terminate 来终止进程。

调试

如果您需要调试服务器，可以以调试模式安装它：

# 使用 npx
npx @wonderwhy-er/desktop-commander@latest setup --debug

# 或者本地安装
npm run setup:debug

这将：

1. 配置 Claude 使用单独的 “desktop-commander” 服务器；
2. 启用 Node.js 调试协议，并添加 --inspect-brk=9229 标志；
3. 在启动时暂停执行，直到调试器连接；
4. 启用额外的调试环境变量。

要连接调试器：

• 在 Chrome 中，访问 chrome://inspect 并查找 Node.js 实例；
• 在 VS Code 中，使用 “附加到 Node.js 进程” 调试配置；
• 其他 IDE 或工具也可能提供类似的 “附加” 选项来进行 Node.js 调试。

重要的调试注意事项：

• 由于设置了 --inspect-brk 标志，服务器会在启动时暂停，直到调试器连接；
• 如果在调试过程中没有看到任何活动，请确保已连接到正确的 Node.js 进程；
• 可能同时运行多个 Node.js 进程，需连接到端口 9229 上的那个；
• 调试服务器在 Claude 的 MCP 服务器列表中会被标识为 “desktop-commander-debug”。

故障排除：

• 如果 Claude 在尝试使用调试服务器时超时，可能是调试器未正确连接；
• 正确连接后，进程将在遇到第一个断点后继续执行；
• 连接后，您可以在 IDE 中添加更多断点。

模型上下文协议集成

该项目扩展了 MCP 文件系统服务器的功能，使其能够实现：

• 在 Claude Desktop 中支持本地服务器；
• 执行完整的系统命令；
• 进程管理；
• 文件操作；
• 代码编辑并支持搜索/替换块。

该项目是探索 Claude MCP 的一部分：https://youtube.com/live/TlbjFDbl5Us

支持 Desktop Commander

❤️ 支持者名人堂

这里展示了慷慨的支持者。感谢您让这个项目成为现实！

Jon Richards

Matija Stepanic

官方网站

请访问我们的官方网站 https://desktopcommander.app/，获取最新资讯、文档及更新。

媒体资源

通过以下资源了解更多关于本项目的信息：

文章

Claude 搭配 MCP 替代 Cursor 和 Windsurf。这是如何做到的？ - 详细探讨具备模型上下文协议能力的 Claude 如何改变开发者的工作流程。

视频

Claude Desktop Commander 视频教程 - 观看如何高效地设置并使用 Commander。

AnalyticsIndiaMag 的报道

这位开发者用 Claude 搭配 MCP 取代了 Windsurf 和 Cursor

社区

加入我们的 Discord 服务器，获取帮助、分享反馈并与其他用户交流。

用户评价

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=UgyyBt6_ShdDX_rIOad4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=UgztdHvDMqTb9jiqnf54AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=UgyQFTmYLJ4VBwIlmql4AaABAg

https://www.youtube.com/watch?v=ly3bed99Dy8&lc=Ugy4-exy166_Ma7TH-h4AaABAg

[ https://medium.com/@pharmx/you-sir-are-my-hero-62cff5836a3e](https://medium.com/@pharmx/you-sir-are-my-hero-62cff5836a3e

如果您觉得这个项目有用，请考虑在GitHub上给它点个⭐星！这有助于更多人发现该项目，并鼓励我们继续开发。

我们欢迎社区贡献！无论您发现了Bug、有功能需求，还是想贡献代码，都可以通过以下方式参与：

• 发现了Bug？ 在github.com/wonderwhy-er/DesktopCommanderMCP/issues中提交一个问题
• 有功能想法？ 在Issues栏目中提交功能请求
• 想贡献代码？ Fork仓库，创建分支，然后提交Pull Request
• 有问题或讨论？ 在GitHub Discussions标签页发起讨论

无论大小贡献，我们都十分感激！

如果您觉得这个工具对您的工作流程很有价值，请考虑支持该项目。

常见问题

以下是几个常见问题的解答。如需更全面的FAQ，请参阅我们的详细FAQ文档。

什么是Desktop Commander？

这是一个MCP工具，可以让Claude Desktop访问您的文件系统和终端，从而将Claude变成一个多功能的助手，用于编码、自动化、代码库探索等。

这和Cursor/Windsurf有什么不同？

与专注于IDE的工具不同，Claude Desktop Commander提供了一种以解决方案为中心的方法，可以与您的整个操作系统协同工作，而不仅限于编码环境。Claude会完整读取文件，而不是分块处理；它可以同时处理多个项目；并且能一次性执行所有更改，而无需反复检查。

我需要为API积分付费吗？

不需要。这个工具是基于Claude Desktop的标准Pro订阅（每月20美元）运行的，不涉及API调用，因此除了订阅费之外不会产生额外费用。

Desktop Commander会自动更新吗？

是的，通过npx或Smithery安装后，只要您重启Claude，Desktop Commander就会自动更新到最新版本。无需手动更新。

最常见的使用场景有哪些？

• 探索和理解复杂的代码库
• 生成图表和文档
• 自动化跨系统的任务
• 同时处理多个项目
• 进行精准控制的手术式代码修改

安装或使用过程中遇到问题，该去哪里求助？

请加入我们的Discord服务器获取社区支持，查看GitHub Issues了解已知问题，或查阅完整FAQ获取故障排除技巧。您也可以访问我们的网站FAQ页面，获得更友好的使用体验。如果遇到新问题，请考虑提交GitHub Issue，并详细说明您的问题。

如何报告安全漏洞？

请在GitHub Issue中提交关于您发现的安全漏洞的详细信息。有关负责任披露的完整指南，请参阅我们的安全政策。

数据收集与隐私

Desktop Commander 会收集有限的、经过假名处理的遥测数据，以改进该工具。我们不会收集文件内容、文件路径或命令参数。

选择退出： 请让 Claude 执行“禁用 Desktop Commander 遥测”操作，或在您的配置中将 "telemetryEnabled": false 设置为真。

有关完整详情，请参阅我们的隐私政策。

验证

许可证

MIT

DesktopCommanderMCP 中文快速上手指南

环境准备

国内用户若 npm 下载慢，可先执行
npm config set registry https://registry.npmmirror.com

安装步骤（任选其一）

方案 1：一行命令自动安装（推荐）

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

重启 Claude Desktop 即可使用。
自动更新：每次重启 Claude 时检查更新。

方案 2：macOS 一键脚本（自动装 Node.js）

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

方案 3：Docker 隔离安装（无需 Node.js）

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)

Windows PowerShell：

iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'))

方案 4：手动写入配置

打开 Claude Desktop 配置文件：

• macOS: ~/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 Desktop。

基本使用

1. 打开 Claude Desktop，新建对话。
2. 直接输入自然语言指令，例如：
   • “在当前目录创建名为 demo 的文件夹”
   • “把 README.md 里的 ‘foo’ 全部替换为 ‘bar’”
   • “运行 python -m http.server 8000 并在后台保持”
3. Claude 会调用 DesktopCommanderMCP 完成操作，并实时返回结果。

最小示例

用户：在当前目录新建 test.py，写入 print("Hello MCP") 并运行
Claude：✅ 已创建 test.py  
✅ 已运行 python test.py  
输出：Hello MCP

至此，安装完成，可开始用自然语言让 AI 帮你管理文件、执行命令、分析数据。