Desktop Commander MCP | 二师兄的博客

type

status

date

slug

summary

项目简介

Desktop Commander MCP 是一个为 Claude 桌面应用设计的 MCP（Model Context Protocol）服务器，旨在提升 Claude 的能力，使其可以执行终端命令、搜索文件系统以及进行差异化的文件编辑。这种工具特别适合开发者和高级用户，能够显著提高工作效率。

功能概述

核心功能

终端工具：

执行终端命令并实时输出。

支持命令超时设置和后台执行。

管理系统进程（列出进程、终止进程）。

管理长时间运行的命令会话。

文件系统工具：

文件操作：读取、写入文件。

文件移动和重命名。

文件搜索：基于模式的搜索。

获取文件元数据。

代码编辑工具：

精确文本替换：适用于小范围修改。

文件整体重写：适用于大范围修改。

支持多文件操作和递归搜索。

安装方法

文件中提供了四种安装方式，用户可以根据需求选择：

1. 通过 npx 安装

运行以下命令即可安装：

如果需要调试模式：

2. 通过 Smithery 安装

使用 Smithery 工具自动安装：

3. 手动修改配置文件

将 MCP 服务器的配置信息手动添加到 Claude 的配置文件中。具体路径因操作系统而异：

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\\Claude\\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

需要添加的内容如下：

4. 本地安装

克隆项目并运行以下命令：

使用方法

终端工具

提供以下功能：

执行命令 (execute_command)。

获取长时间运行命令的输出 (read_output)。

强制终止命令会话 (force_terminate)。

列出活动命令会话 (list_sessions)。

列出系统进程 (list_processes)。

终止进程 (kill_process)。

管理命令黑名单 (block_command/unblock_command)。

文件系统工具

支持以下操作：

文件读取/写入 (read_file/write_file)。

目录管理 (create_directory/list_directory)。

文件移动 (move_file)。

模式搜索文件 (search_files)。

获取文件元数据 (get_file_info)。

代码递归搜索 (search_code)。

编辑工具

支持文本替换和文件重写：

小范围修改使用 edit_block。

大范围修改或失败时使用 write_file。

替换格式示例如下：

长时间运行的命令处理

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

使用 execute_command 执行命令，初始输出会返回。

命令在后台继续运行。

使用 read_output 获取新的输出。

如果需要，可以使用 force_terminate 停止命令。

调试模式

提供了调试模式以帮助开发者定位问题：

使用 -debug 标志安装调试版本。

调试时会启用 Node.js Inspector 协议。

可以在 Chrome 或 VS Code 中连接调试。

数据收集

安装和设置过程中会收集匿名使用数据，包括：

操作系统信息。

Node.js 和 NPM 版本。

安装方法和 Shell 环境。

错误信息。

这些数据用于改进工具性能，并且不包含个人信息。

开源协议

项目使用 MIT 开源协议，用户可以自由使用、修改和分发。