用途:Desktop Commander MCP 让智能体触达用户电脑上的文件、文件夹、终端、进程、结构化文档以及可通过 SSH 访问的远程主机。各工具的详细参数与返回结构定义在 MCP 本身,本条目说明其能力与常见组合方式。
主要能力:持久 shell 会话,单个会话内环境变量、工作目录、已激活虚拟环境、连接与 REPL 变量可跨多次工具调用保留;同一会话内持久,但不同的 start_process 调用互不共享状态。长时运行进程可后台启动开发服务器、监听、构建、训练或测试,并返回句柄供持续读取、交互或终止。文件系统可读写、移动、列举和检查用户授权范围内的任意路径,包括工作区外目录。edit_block 以精确字符串查找替换文件,歧义匹配会直接报错,expected_replacements 可防止部分匹配;但旧的 old_string 或错误的 expected_replacements 仍可能损坏内容,改完需核对。Excel、DOCX、PDF 由格式专用机制直接处理,而非纯文本近似;图片与 PDF 可返回为可查看内容。搜索基于 ripgrep 流式执行,可选文件名或文件内容搜索,支持分页与并发。SSH 长会话可跨多轮连接一次后持续读日志、诊断、部署或调试。进程管理可列举、检查、跟踪、终止有权限的进程。
使用方式:工具按功能分组。进程与 shell 包括 start_process、interact_with_process、read_process_output、list_processes、list_sessions、kill_process、force_terminate;文件读写真包括 read_file、read_multiple_files、write_file、edit_block、write_pdf;文件系统包括 list_directory、get_file_info、move_file、create_directory;搜索包括 start_search、get_more_search_results、list_searches、stop_search;诊断与配置包括 get_recent_tool_calls、get_config。DOCX 编辑需两次读取:offset 0 返回大纲,非零 offset 才进入原始 XML 模式,再以 XML 片段做 edit_block。write_pdf 可通过 operations 数组在现有 PDF 上插入或删除页面并生成新文件。
适用场景:调试生产问题、部署到预发、运行开发服务器并迭代 API、在 monorepo 中重构、更新表格数字与报告摘要、生成 PDF 报告、分析大型 CSV、运行一次性 Node 脚本、理解代码库、整理下载目录、恢复上次会话上下文。
限制与约定:文件操作仅在用户配置的 allowedDirectories 内有效,越权路径会返回 [DENIED] 或被拒绝,应将被拒路径告知用户而非重试。建议使用绝对路径,相对路径与 ~ 路径可能失效。macOS 默认 shell 为 zsh,应使用 python3 而非 python,部分 GNU 工具带 gsed 等前缀;Windows 与 Linux 行为不同,应先通过 get_config 或 shell 检测平台。长输出均支持 offset 与 length,负 offset 表示从末尾读取。生产影响类 SSH 命令、部署、重启、迁移等环境变更操作前,应说明意图并在风险不低时取得用户确认。其他收费、价格等信息暂未提供。