内容
# 远程桌面指挥官
**在任何地方构建、探索、自动化您的计算机。**
从支持远程MCP连接器的任何AI应用程序中访问您的计算机的文件系统和终端。远程桌面指挥官是一个托管的[MCP](https://modelcontextprotocol.io)服务器，它中继到您实际机器的安全连接，为您的AI助手提供与本地服务器相同的完整文件和 shell 访问权限 — 而无需您亲自操作键盘。
- **服务器端点：** `https://mcp.desktopcommander.app/mcp` （可流式传输的HTTP，OAuth 2.0）
- **仪表盘：** [mcp.desktopcommander.app](https://mcp.desktopcommander.app)
- **状态：** 目前处于测试阶段
- **演示：** [观看视频](https://youtu.be/C2kH5itFsGg)
> 此仓库托管公共清单、文档和托管服务的issue跟踪器。服务实现并非开源。有关开源本地（stdio）服务器，请参阅 [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP)。
## 您可以使用
- **从头开始构建** — 使用简单的命令创建功能和应用程序
- **管理开发环境** — 设置服务器、配置系统、处理进程
- **探索现有代码库** — 导航和理解复杂仓库
- **原位编辑文档** — 在磁盘上处理Word、Excel和PDF文件
- **管理上下文和文档** — 跟踪项目详细信息和技术规范
- **控制多台机器** — 将多台计算机配对并在一次对话中按名称寻址
## 快速开始
### 1. 启动设备代理
在您要控制的计算机上：
```bash
npx @wonderwhy-er/desktop-commander@latest remote
```
您的浏览器会打开一个验证页面，显示配对代码（也会在终端中打印 — 标准OAuth设备流检查）。登录，确认代码匹配，终端会报告“设备就绪”。保持代理运行：关闭终端，无访问权限。
### 2. 连接您的AI客户端
每个客户端在首次连接时都会引导您完成OAuth登录。
**claude.ai / Claude Desktop** — 设置 → 连接器 → **添加自定义连接器**，然后输入：
```
https://mcp.desktopcommander.app/mcp
```
**Claude Code：**
```bash
claude mcp add --transport http remote-desktop-commander https://mcp.desktopcommander.app/mcp
```
（如果您在此仓库的检出中工作，Claude Code还会自动获取包含的 [.mcp.json](.mcp.json)。）
**ChatGPT** — 设置 → 应用程序和连接器 → 高级设置 → 启用 **开发者模式** （需要包含它的计划），然后 **创建连接器** 并输入：
```
https://mcp.desktopcommander.app/mcp
```
**Cursor** — 添加到 `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"remote-desktop-commander": {
"url": "https://mcp.desktopcommander.app/mcp"
}
}
}
```
**VS Code** — 添加到 `.vscode/mcp.json` 在您的 工作区（或用户级 `mcp.json`）：
```json
{
"servers": {
"remote-desktop-commander": {
"type": "http",
"url": "https://mcp.desktopcommander.app/mcp"
}
}
}
```
**Gemini CLI：**
```bash
gemini extensions install https://github.com/desktop-commander/remote-desktop-commander
```
### 3. 尝试
这些操作针对运行代理的任何机器，无需设置：
> “列出我的主目录的内容并告诉我里面有什么。”
>
> “在我的文档文件夹中创建一个名为ai-test的文件夹。在其中编写一个打印日期的简短Python脚本并运行它。”
>
> “在我的机器上启动一个Python REPL，导入pandas，并告诉我已安装的版本。保持会话活跃。”
>
> “搜索我的主目录中最近24小时内修改的文件，并按文件夹分组。”
完整的演练和故障排除： [docs/SETUP.md](docs/SETUP.md)
## 要求
- 每个要控制的计算机上都需要Node.js 18或更新版本（用于`npx`）
- 每台机器上运行一个终端代理
- 支持 **macOS, Windows, 和 Linux**
## 可用工具
| 类别 | 工具 |
|---|---|
| **读取和探索** | 读取文件、读取多个文件、列出目录、获取文件信息 |
| **搜索** | 开始搜索、获取更多搜索结果、停止搜索、列出活动搜索 |
| **编写和编辑** | 编写文件、编辑文件块、移动或重命名文件、创建目录、编写或修改PDF |
| **终端和进程** | 启动进程、向进程发送输入、读取进程输出、列出活动会话、列出系统进程、终止会话、终止系统进程 |
| **设备和账户** | 列出配对设备、当前用户信息、ping设备、关闭设备代理 |
| **配置和帮助** | 获取配置、设置配置值、获取提示库、获取最近的工具活动、获取使用统计、提交反馈 |
## 工作原理
```mermaid
sequenceDiagram
participant AI as AI 应用（网页，移动，桌面）
participant S as mcp.desktopcommander.app
participant D as 您的计算机（设备代理）
AI->>S: MCP 工具调用（OAuth 2.0 bearer）
S->>D: 中继到您的配对设备
D->>D: 在本地执行
D->>S: 结果
S->>AI: MCP 响应
```
- 身份验证是标准的 **OAuth 2.0 with PKCE**；设备通过OAuth **设备授权流程**（您在设置时看到的短码批准）进行配对。
- 服务器仅访问通过工具调用明确请求的数据；传输在传输过程中加密（HTTPS/TLS）。
- 只有在其设备代理运行时，机器才可访问 — 使用 `Ctrl+C` 停止它，访问权限就会结束。设备也可以在任何时候从 [仪表盘](https://mcp.desktopcommander.app) 中审查和撤销。
- 工具使用 **您的用户帐户权限** 在配对机器上执行，因此请像对待凭证一样保护您的连接AI帐户，并使用MFA。阅读完整的信任模型，参见 [SECURITY.md](SECURITY.md)。
## 支持与法律
- **设置指南：** [docs/SETUP.md](docs/SETUP.md)
- **错误和功能请求：** [GitHub Issues](https://github.com/desktop-commander/remote-desktop-commander/issues) · **贡献：** [CONTRIBUTING.md](CONTRIBUTING.md)
- **社区：** [Discord](https://discord.gg/kQ27sNnZr7)
- **安全报告：** 参见 [SECURITY.md](SECURITY.md)
- **隐私政策：** [远程桌面指挥官隐私政策](https://legal.desktopcommander.app/#/remote_privacy_policy) · **服务条款：** [legal.desktopcommander.app](https://legal.desktopcommander.app/#/terms_of_service)
- **许可证：** [LICENSE](LICENSE) — 此仓库仅包含文档和清单；托管服务是专有的
## 相关
- [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP) — 开源本地MCP服务器（npm： [`@wonderwhy-er/desktop-commander`](https://www.npmjs.com/package/@wonderwhy-er/desktop-commander)），它还附带用于配对的`remote`设备代理
- [desktopcommander.app](https://desktopcommander.app) — 产品网站
