基本能力
产品定位
Desktop Commander MCP 是一个增强 Claude 桌面应用功能的工具,使其能够执行终端命令、管理文件系统、进行代码编辑和搜索,从而提升开发效率和自动化任务处理能力。
核心功能
- 终端命令执行:支持执行终端命令并实时流式输出,支持超时和后台执行。
- 进程管理:列出和终止系统进程。
- 文件系统操作:读写文件、创建/列出目录、移动文件、搜索文件、获取文件元数据。
- 代码编辑:支持精确的文本替换和完整的文件重写。
- 代码搜索:基于 ripgrep 的递归文本和代码搜索。
- URL 支持:从 URL 读取内容,支持文本和图像。
适用场景
- 代码编辑与重构:通过精确的搜索和替换功能进行代码修改。
- 文件管理:自动化文件操作,如批量重命名、移动或搜索文件。
- 终端命令执行:运行复杂的终端命令并实时查看输出。
- 代码库探索:快速搜索和理解大型代码库。
工具列表
- 终端工具:
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
。
常见问题解答
- 什么是 Claude Desktop Commander?:它是一个 MCP 工具,使 Claude 桌面应用能够访问文件系统和终端。
- 与 Cursor/Windsurf 的区别?:提供更全面的系统级操作,而不仅限于 IDE 环境。
- 是否需要支付 API 费用?:不需要,仅需 Claude Pro 订阅。
- 如何获取帮助?:可通过 Discord、GitHub issues 或网站 FAQ 获取支持。
使用教程
使用依赖
- 安装 Claude 桌面应用。
- 确保已安装 npm。
安装教程
-
通过 npx 安装:
bash
npx @wonderwhy-er/desktop-commander@latest setup
调试模式:
bash
npx @wonderwhy-er/desktop-commander@latest setup --debug -
使用 bash 脚本安装(macOS):
bash
curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash -
通过 Smithery 安装:
bash
npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude -
手动添加到 claude_desktop_config:
修改claude_desktop_config.json
文件,添加以下内容:
json
{
"mcpServers": {
"desktop-commander": {
"command": "npx",
"args": [
"-y",
"@wonderwhy-er/desktop-commander"
]
}
}
} -
本地克隆并构建:
bash
git clone https://github.com/wonderwhy-er/ClaudeComputerCommander.git
cd ClaudeComputerCommander
npm run setup
调试方式
- 安装调试模式:
bash
npx @wonderwhy-er/desktop-commander@latest setup --debug
或
bash
npm run setup:debug - 连接调试器:
- 在 Chrome 中访问
chrome://inspect
。 - 在 VS Code 中使用 "Attach to Node Process" 配置。
- 调试端口:
9229
。