Remote Desktop Commander

Remote Desktop Commander

随时随地，在你的电脑上构建、探索和自动化。

通过任何支持远程 MCP 连接器的 AI 应用，访问你电脑上的文件系统和终端。Remote Desktop Commander 是一个托管的 MCP 服务，可将安全连接中继到你的真实机器，让 AI 助手像使用本地服务一样，全面访问文件和 Shell——无需你守在键盘前。

• 服务端点： https://mcp.desktopcommander.app/mcp（Streamable HTTP、OAuth 2.0）
• 控制面板： mcp.desktopcommander.app
• 状态： 目前处于 Beta 阶段
• 演示： 观看视频

此仓库托管该托管服务的公开清单、文档和问题跟踪器。服务实现不开源。如需开源的本地（stdio）服务，请参阅 DesktopCommanderMCP。

你可以做什么

• 从头开始构建——通过简单命令创建功能和应用程序
• 管理开发环境——设置服务、配置系统、处理进程
• 探索现有代码库——浏览并理解复杂的代码仓库
• 就地编辑文档——直接在磁盘上的原位置处理 Word、Excel 和 PDF 文件
• 管理上下文和文档——跟踪项目详情和技术规范
• 控制多台机器——配对多台电脑，并在一次对话中按名称指定它们

快速开始

1. 启动设备 Agent

在你要控制的电脑上：

npx @wonderwhy-er/desktop-commander@latest remote

浏览器会打开一个验证页面，显示配对码（终端中也会显示；这是标准的 OAuth 设备流验证）。登录并确认配对码一致后，终端会显示“Device ready”。请让 Agent 持续运行：关闭终端后将无法访问。

2. 连接 AI 客户端

每个客户端首次连接时都会引导你通过 OAuth 登录。

claude.ai / Claude Desktop — 设置 → 连接器 → 添加自定义连接器，然后输入：

https://mcp.desktopcommander.app/mcp

Claude Code：

claude mcp add --transport http remote-desktop-commander https://mcp.desktopcommander.app/mcp

（如果你在此仓库的检出目录中工作，Claude Code 也会自动读取其中的 .mcp.json。）

ChatGPT — 设置 → 应用和连接器 → 高级设置 → 启用开发者模式（需要包含此功能的套餐），然后选择创建连接器并输入：

https://mcp.desktopcommander.app/mcp

Cursor — 一键添加：添加到 Cursor。或者手动添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "remote-desktop-commander": {
      "url": "https://mcp.desktopcommander.app/mcp"
    }
  }
}

VS Code — 安装 Agent 插件（内置此服务）：

copilot plugin install desktop-commander/remote-desktop-commander

或者直接将服务添加到工作区中的 .vscode/mcp.json（或用户级 mcp.json）：

{
  "servers": {
    "remote-desktop-commander": {
      "type": "http",
      "url": "https://mcp.desktopcommander.app/mcp"
    }
  }
}

Gemini CLI：

gemini extensions install https://github.com/desktop-commander/remote-desktop-commander

3. 试试看

以下操作适用于任何正在运行 Agent 的机器，无需额外设置：

“列出我的主目录内容，并告诉我里面有什么。”

“在我的 Documents 文件夹中创建一个名为 ai-test 的文件夹。在里面写一个简短的 Python 脚本，用于打印日期，然后运行它。”

“在我的机器上启动 Python REPL，导入 pandas，并告诉我安装的是哪个版本。保持会话运行。”

“搜索我的主目录，找出过去 24 小时内修改的文件，并按文件夹分组。”

完整操作指南及故障排查：docs/SETUP.md

要求

• 每台要控制的电脑上都需安装 Node.js 18 或更高版本（用于 npx）
• 每台机器上运行一个终端来启动设备 Agent
• 支持 macOS、Windows 和 Linux

可用工具

类别	工具
读取与浏览	读取文件、读取多个文件、列出目录、获取文件信息
搜索	开始搜索、获取更多搜索结果、停止搜索、列出活动搜索
写入与编辑	写入文件、编辑文件块、移动或重命名文件、创建目录、写入或修改 PDF
终端与进程	启动进程、向进程发送输入、读取进程输出、列出活动会话、列出系统进程、终止会话、结束系统进程
设备与账户	列出已配对设备、当前用户信息、Ping 设备、关闭设备 Agent
配置与帮助	获取配置、设置配置值、获取提示词库、获取近期工具活动、获取使用统计、提交反馈

工作原理

sequenceDiagram
    participant AI as AI app (web, mobile, desktop)
    participant S as mcp.desktopcommander.app
    participant D as Your computer (device agent)
    AI->>S: MCP tool call (OAuth 2.0 bearer)
    S->>D: relayed to your paired device
    D->>D: executes locally
    D->>S: result
    S->>AI: MCP response

• 身份验证采用标准的 OAuth 2.0 with PKCE；设备通过 OAuth 设备授权流程配对（即设置时看到的短代码审批）。
• 服务只会访问通过工具调用明确请求的数据；传输过程采用加密（HTTPS/TLS）。
• 只有设备 Agent 正在运行时，才能访问相应机器——使用 Ctrl+C 停止后，即无法继续访问。你也可以随时在控制面板中查看并撤销设备。
• 工具在配对机器上使用你的用户账户权限执行，因此请将已连接的 AI 账户视作凭据，并使用 MFA 加以保护。请阅读 SECURITY.md 了解完整的信任模型。

支持与法律信息

• 设置指南： docs/SETUP.md
• 错误报告与功能请求： GitHub Issues · 贡献： CONTRIBUTING.md
• 社区： Discord
• 安全问题报告： 请参阅 SECURITY.md
• 隐私政策： Remote Desktop Commander 隐私政策 · 服务条款： legal.desktopcommander.app
• 许可证： LICENSE — 此仓库仅包含文档和清单；托管服务为专有软件

相关项目

• DesktopCommanderMCP — 开源的本地 MCP 服务（npm：@wonderwhy-er/desktop-commander），也提供用于配对的 remote 设备 Agent
• desktopcommander.app — 产品网站