MCP:通过您的 AI 工具控制 FlashDesk
FlashDesk 实现了 MCP(Model Context Protocol,模型上下文协议),这是一种将 AI 工具连接到外部应用程序的开放标准。Claude、ChatGPT、Cursor 和 Windsurf 等 AI 工具可以通过自然语言查看屏幕、控制鼠标和键盘、管理文件、运行 SSH 命令以及检查远程设备的性能。
内容
概述
MCP(Model Context Protocol,模型上下文协议)是一项开放标准,允许 AI 工具直接调用外部应用程序,无需自定义脚本或专用集成。任何与 MCP 兼容的 AI 工具只要运行在与 FlashDesk 相同的 PC 上,即可将 FlashDesk 注册为本地 MCP 服务器并立即使用,FlashDesk 的设置界面会显示确切的配置以供粘贴。
FlashDesk MCP 实际应用案例
以下实际案例结合了屏幕查看与控制、SSH 排查以及日志和数据库检查。AI 工具通过 FlashDesk MCP 获取信息并执行操作。
-
排查屏幕显示与实际状态不一致的原因
将屏幕显示和处理状态与日志、设置及数据库记录进行对照,排查显示不一致和处理停滞的原因。 -
配置新 Linux PC 的环境
完成了远程访问、Docker 和所需应用的安装配置,从备份恢复数据库,以及网络和时间同步设置。 -
排查 PC 之间无法连接的原因
通过检查屏幕上的设置和连接状态,排查网络配置和多个网络接口相关的问题。对于无法直接连接 FlashDesk 的 PC,如果可以从同一网络内获准使用且已连接的 PC 通过 SSH 访问,也可以进行排查。 -
恢复无法启动的应用
排查了更新后的启动问题,以及日志不断增多造成的磁盘空间不足。处理工作包括清理日志、检查设置,以及修复 Mac 上 VS Code 的启动问题。 -
在真实设备上测试 Windows 和 macOS 应用
通过截图检查屏幕显示,验证点击和键盘输入是否传递到应用,并确认操作后的屏幕变化。 -
让常用排查步骤可以重复使用
将常用的日志检查和数据库查询整理成脚本,以便后续排查时重复使用相同的步骤。
基本用法
在 FlashDesk 设置中启用 MCP
在运行您的 AI 工具的设备上,打开 FlashDesk 设置中的外部 AI 工具访问权限。默认为关闭。
将 FlashDesk 注册为 MCP 服务器
同一设置屏幕显示了用于注册的准确配置,并提供复制按钮。将其粘贴到您的 AI 工具自身的 MCP 设置中。每个 AI 工具有其自身的位置来注册本地 MCP 服务器——请查看该工具的 MCP 文档以了解具体位置。
{
"mcpServers": {
"flashdesk": {
"command": "C:\\Users\\YourName\\AppData\\Local\\FlashDesk\\app\\FlashDesk.exe",
"args": ["--mcp-server"]
}
}
}
让您的 AI 工具连接
告诉 AI 工具要连接哪台已保存的设备。连接会经过远程设备上正常的批准流程。
用自然语言进行操作
连接后,描述您希望完成的操作。AI 工具将选择正确的行动——截取屏幕、点击、输入文本、移动光标或整理文件,或运行命令。
你能做什么
- 列出保存的连接和文件夹,查看哪些设备在线,以及打开、检查和关闭会话。
- 获取远程屏幕的实时截图,可以是整个屏幕或单个区域,并在 Windows 上读取前景窗口的标题及其位置。
- 在远程设备上移动鼠标、点击、双击、滚动、按下按键以及输入文本。
- 读取和设置剪贴板,已与远程设备同步。
- 列出、上传、下载、重命名和删除文件及文件夹——既包括在远程设备上,也包括在运行 AI 工具的设备上。
- 启动仅 SSH 的会话(无屏幕窗口),并在远程设备上运行 shell 命令。
- 启动、停止并检查屏幕录制的状态。
- 发送和读取会话聊天消息,这些消息会被远程设备上的用户看到。
- 读取实时视频统计信息——帧率、往返时间、丢包率、拥塞级别以及 Host 的 CPU 和内存使用情况——并调整目标帧率、管道深度和 JPEG 质量。
- 检查并在远程设备上应用 FlashDesk 更新,以及在任一端退出或重启 FlashDesk。
- 组织连接列表:重命名连接,创建、重命名和删除文件夹,以及在不同文件夹之间移动连接。
支持的 AI 工具
FlashDesk 可与任何兼容 MCP 的 AI 工具配合使用,包括:
- Claude Desktop 和 Claude Code
- ChatGPT 桌面应用和 Codex CLI
- Cursor
- Windsurf
- 搭配 GitHub Copilot Chat 的 VS Code
每种工具注册本地 MCP 服务器的位置各不相同——通常是一个设置文件或一条 CLI 命令。仅限网页版的 AI 聊天界面通常只支持远程 MCP 服务器,而不支持像 FlashDesk 这样的本地服务器;请改用相应的桌面应用或 CLI。
它是如何运作的
| 物品 | 描述 |
|---|---|
--mcp-server |
用于将 FlashDesk 启动为本地 MCP 服务器的标志。此进程仅将请求桥接到 FlashDesk;它本身永远不会成为 Host 或 Viewer。 |
| 仅限本地 | MCP 服务器通过本地标准输入/输出进行通信,永远不会暴露给网络。 |
| FlashDesk 必须运行 | 桥接进程会将每个请求传递给已在同一台 PC 上运行的 FlashDesk。如果 FlashDesk 未运行,请求将返回错误,而不会自行启动任何内容。 |
| 相同的批准流程 | 通过 MCP 打开的连接在远程设备上会经过与由用户手动启动的连接相同的批准或共享密码流程。 |