让 AI 助手替你操作远程桌面的接口

从 1.45.10 版本起，HopToDesk 内置了 MCP（Model Context Protocol）服务器——AI 代理可以编程方式查看屏幕、动鼠标、管连接。这是把「AI 帮我运维」从口号落到实操的接口。

三种传输模式

WebSocket / TCP 模式的首条消息必须是鉴权令牌；令牌自动写入配置目录的 mcp.json 发现文件（Unix 下权限收紧为 0600，程序退出即删除）。

{
  "mcpServers": {
    "hoptodesk": {
      "command": "/path/to/hoptodesk",
      "args": ["--mcp"]
    }
  }
}

stdio 模式零配置；WebSocket 模式让代理自己读 mcp.json 拿地址和令牌。

屏幕与输入：截图（可裁剪）、窗口列表、点击、移动、打字、按键组合。
设备信息：本机 ID 与版本、对端列表（最近 / 收藏 / 局域网过滤）。
连接管理：发起连接（远程桌面 / 传文件 / 端口转发）、断开、列出入站与出站会话。
会话控制：读 UI 状态（连接质量、编解码、对话框）、等待事件、关对话框、点工具栏按钮、发聊天消息。
权限：远程切换键鼠、剪贴板、音频、文件、录制等权限。
剪贴板与文件：读写本机剪贴板、列目录、读文件（二进制走 base64，上限 1 MB）。
远程打印：配置打印机、发测试页。
系统操作（面板注册设备专属）：系统信息、磁盘占用、进程列表、网络信息、服务日志、重启设备等预置操作，以及执行任意 shell 命令（默认 30 秒超时）。