mcp/desktop-commander

Desktop Commander MCP Server

镜像概述和主要用途

Desktop Commander MCP Server 是一个基于模型上下文协议(MCP)的服务器应用，允许用户通过AI搜索、更新、管理文件和运行终端命令。它提供了一系列工具，使AI能够与本地文件系统和进程进行交互，实现自动化任务处理和工作流管理。

什么是MCP服务器？

核心功能和特性

• 提供25种不同工具，涵盖文件管理、进程控制、系统信息查询等功能
• 支持文件的创建、读取、编辑、移动和搜索
• 能够启动、监控和终止终端进程
• 提供配置管理和使用统计功能
• 支持部分文件读取和搜索结果分页
• 提供交互式进程交互，支持多种REPL环境
• 包含安全性限制，仅允许在指定目录内操作
• 提供详细的工具调用历史记录，便于调试和上下文恢复

使用场景和适用范围

• 开发者自动化：通过AI辅助完成文件操作、代码编辑和进程管理
• 系统管理：监控和管理系统进程，获取系统信息和使用统计
• 数据处理：通过集成的Python REPL环境分析本地文件数据
• 工作流自动化：创建自定义工作流，自动执行一系列文件和系统操作
• AI助手集成：作为AI助手的后端服务，提供本地系统交互能力

MCP信息

镜像构建信息

Docker部署方案

使用docker run部署

bash
docker run -d \
  --name desktop-commander \
  -p 8080:8080 \
  -v /path/to/allowed/directory:/data \
  -e ALLOWED_DIRECTORIES=/data \
  -e DEFAULT_SHELL=/bin/bash \
  -e FILE_READ_LINE_LIMIT=1000 \
  -e TELEMETRY_ENABLED=false \
  mcp/desktop-commander

使用docker-compose部署

yaml
version: '3.8'

services:
  desktop-commander:
    image: mcp/desktop-commander
    container_name: desktop-commander
    ports:
      - "8080:8080"
    volumes:
      - /path/to/allowed/directory:/data
    environment:
      - ALLOWED_DIRECTORIES=/data
      - DEFAULT_SHELL=/bin/bash
      - FILE_READ_LINE_LIMIT=1000
      - FILE_WRITE_LINE_LIMIT=50
      - TELEMETRY_ENABLED=false
    restart: unless-stopped

环境变量配置

可用工具 (25个)

工具详情

工具: create_directory

创建新目录或确保目录存在。

可以一次性创建多个嵌套目录。仅在允许的目录内工作。

重要提示: 为确保可靠性，始终使用绝对路径。无论斜杠方向如何，路径都会自动规范化。相对路径可能会失败，因为它们依赖于当前工作目录。波浪号路径 (~/...) 可能在所有上下文中都不起作用。除非用户明确要求使用相对路径，否则请使用绝对路径。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

---

工具: edit_block

编辑文本块

最佳实践: 进行多次小的、有针对性的编辑，而不是一次大的编辑。每个edit_block调用应只更改需要更改的内容 - 仅包含足够的上下文以唯一标识要修改的文本。

参数:

• file_path: 要编辑的文件路径
• old_string: 要替换的文本
• new_string: 替换文本
• expected_replacements: 可选参数，替换次数

默认情况下，仅替换搜索文本的一次出现。要替换多次出现，请提供expected_replacements参数，并指定预期的匹配次数。

唯一性要求: 当expected_replacements=1（默认值）时，包含必要的最少上下文（通常是更改点前后1-3行），并保持确切的空格和缩进。

编辑多个部分时，对每个不同的更改进行单独的edit_block调用，而不是一次大的替换。

当找到接近但不完全匹配的内容时，将以以下格式显示字符级差异：common_prefix{-removed-}{+added+}common_suffix，以帮助您识别差异。

与write_file类似，有一个可配置的行限制(fileWriteLineLimit)，如果编辑的文件超过此限制，会发出警告。如果发生这种情况，请考虑将您的编辑分解为更小、更有针对性的更改。

重要提示: 为确保可靠性，始终使用绝对路径。无论斜杠方向如何，路径都会自动规范化。相对路径可能会失败，因为它们依赖于当前工作目录。波浪号路径 (~/...) 可能在所有上下文中都不起作用。除非用户明确要求使用相对路径，否则请使用绝对路径。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

此工具可能执行破坏性更新。

---

工具: force_terminate

强制终止进程

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

此工具可能执行破坏性更新。

---

工具: get_config

获取完整的服务器配置（JSON格式）。配置包括以下字段：

• blockedCommands（被阻止的shell命令数组）
• defaultShell（用于命令的shell）
• allowedDirectories（服务器可以访问的路径）
• fileReadLineLimit（read_file的最大行数，默认1000）
• fileWriteLineLimit（每个write_file调用的最大行数，默认50）
• telemetryEnabled（遥测选择加入/退出的布尔值）
• currentClient（有关当前连接的MCP客户端的信息）
• clientHistory（所有已连接客户端的历史记录）
• version（DesktopCommander的版本）
• systemInfo（操作系统和环境详细信息）

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

---

工具: get_file_info

检索文件或目录的详细元数据，包括：

• 大小
• 创建时间
• 最后修改时间
• 权限
• 类型
• lineCount（文本文件）
• lastLine（文本文件的最后一行索引）
• appendPosition（文本文件的追加位置行号）

仅在允许的目录内工作。

重要提示: 为确保可靠性，始终使用绝对路径。无论斜杠方向如何，路径都会自动规范化。相对路径可能会失败，因为它们依赖于当前工作目录。波浪号路径 (~/...) 可能在所有上下文中都不起作用。除非用户明确要求使用相对路径，否则请使用绝对路径。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

此工具是只读的。它不会修改其环境。

---

工具: get_more_search_results

使用基于偏移量的分页从活动搜索中获取更多结果。

支持部分结果读取：

• 'offset'（开始结果索引，默认值：0）
  • 正数：从结果N开始（0-based索引）
  • 负数：从末尾读取最后N个结果（尾部行为）
• 'length'（要读取的最大结果数，默认值：100）
  • 与正偏移量一起使用以进行范围读取
  • 当偏移量为负数时忽略（读取所有请求的尾部结果）

示例:

• offset: 0, length: 100 → 前100个结果
• offset: 200, length: 50 → 结果200-249
• offset: -20 → 最后20个结果
• offset: -5, length: 10 → 最后5个结果（忽略长度）

仅返回指定范围内的结果以及搜索状态。

类似于read_process_output - 重复调用此函数以从start_search启动的搜索中获取渐进式结果。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

此工具是只读的。它不会修改其环境。

---

工具: get_prompts

浏览和检索用于各种任务和工作流的精选Desktop Commander提示。

重要提示: 向用户显示提示列表时，请勿显示内部提示ID（如'onb_001'）。这些ID仅供您参考。仅向用户显示提示标题和描述。响应元数据中将提供ID供您使用。

Desktop Commander介绍: 如果用户询问"什么是Desktop Commander？"或类似关于Desktop Commander功能的问题，回答有可用的示例用例和教程，然后调用get_prompts，action='list_prompts'和category='onboarding'来向他们展示。

操作:

• list_categories: 显示所有可用的提示类别
• list_prompts: 列出提示（可按类别筛选）
• get_prompt: 通过ID检索并执行特定提示

工作流程:

1. 使用list_categories查看可用类别
2. 使用list_prompts浏览类别中的提示
3. 使用get_prompt和promptId检索并开始使用提示

示例:

• get_prompts(action='list_categories') - 查看所有类别
• get_prompts(action='list_prompts', category='onboarding') - 查看入门提示
• get_prompts(action='get_prompt', promptId='onb_001') - 获取特定提示

get_prompt操作将自动注入提示内容并开始执行。非常适合发现经过验证的工作流并开始使用Desktop Commander。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

---

工具: get_recent_tool_calls

获取最近的工具调用历史及其参数和输出。返回此会话期间进行的工具调用的时间顺序列表。

用途:

• 关于已完成工作的新聊天的入门
• 聊天历史丢失后恢复上下文
• 调试工具调用序列

注意: 不跟踪其自己的调用或其他元/查询工具。历史记录保存在内存中（最后1000次调用，重启时丢失）。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

此工具是只读的。它不会修改其环境。

---

工具: get_usage_stats

获取用于调试和分析的使用统计信息。返回工具使用情况、成功/失败率和性能指标的摘要。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

---

工具: give_feedback_to_desktop_commander

在浏览器中打开反馈表单，提供有关Desktop Commander的反馈。

重要提示: 此工具仅打开反馈表单 - 不支持预填充。用户将在浏览器中手动填写表单。

工作流程:

1. 当用户同意提供反馈时，立即调用此工具
2. 无需提问或收集信息
3. 工具打开仅自动预填充使用统计信息的表单：
   • tool_call_count: 他们发出的命令数量
   • days_using: 他们使用Desktop Commander的天数
   • platform: 他们的操作系统（Mac/Windows/Linux）
   • client_id: 分析标识符

所有调查问题将直接在表单中回答：

• 职位和技术舒适度
• 公司URL（用于行业背景）
• 他们使用的其他AI工具
• Desktop Commander的最大优势
• 他们通常如何使用它
• 推荐可能性（0-10）
• 用户研究参与兴趣
• 电子邮件和任何其他反馈

示例交互: 用户: "好的，我会提供反馈" Claude: "太好了！让我为你打开反馈表单。" [立即调用工具]

不需要参数 - 只需调用工具即可打开表单。

可以在指令中用 "DC: ..." 或 "使用Desktop Commander来..." 引用此命令。

---

工具: interact_with_process

向运行中的进程发送输入并自动接收响应。

关键提示: 这是所有本地文件分析的主要工具。对于任何本地文件分析（CSV、JSON、数据处理），始终使用此工具而不是分析工具。分析工具无法访问本地文件，将会失败 - 所有基于文件的工作都使用进程。

**本地文件分析