用途:Desktop Commander 是一套 MCP 工具(通常以 mcp__desktop-commander__* 形式调用),用于在本机处理文件、执行精确编辑、搜索内容以及运行长时间进程,把机器操作转化为可验证的工具调用,而不是把本机当作黑盒。
主要能力:读取内容可用 mcp__desktop-commander__read_file,支持分页、负数偏移取尾部,以及 PDF/图片/Excel/URL;小改动用 mcp__desktop-commander__edit_block 做定向文本替换或 Excel 区域更新;大改动用 mcp__desktop-commander__write_file 分块写入,遵守 fileWriteLineLimit。交互式工作用 mcp__desktop-commander__start_process、mcp__desktop-commander__interact_with_process 与 mcp__desktop-commander__read_process_output。搜索用 mcp__desktop-commander__start_search 配合 mcp__desktop-commander__get_more_search_results,按文件名或内容查找。
使用方式:找文件用 searchType="files";找内容用 searchType="content" 并分页,完成后 stop_search。读内容用 offset/length,尾部用 offset=-N,多文件用 read_multiple_files,URL 需 isUrl: true。小改动用 edit_block,多次替换设 expected_replacements。重写用 write_file 按 25–30 行分块(先 rewrite 再 append)。Excel 读取用 read_file、编辑用 edit_block(区域加二维数组)。PDF 只能用 write_pdf,不能用 write_file。进程方面,一次性命令用 start_process 再读输出,REPL/SSH/数据库/开发服务器用 start_process → interact_with_process → read_process_output,长任务定期读输出,停止用 kill_process/force_terminate。可用 list_sessions/list_processes 查看状态,get_recent_tool_calls、get_usage_stats、get_config/set_config_value 做审计与配置。
限制与安全:优先使用绝对路径,不要假定操作系统特定分隔符;大改动先读、保持小步、分块写并留存回滚思路。高风险操作需明确确认后再执行,如配置变更、杀死会话或进程、批量编辑或移动、任何可能造成数据丢失的操作;官方建议把配置变更放在单独会话中进行。allowedDirectories 只限制文件系统工具,不约束终端命令,不应视为沙箱。其余信息暂未提供。