适合谁
- Windows 10/11 用户,希望让 AI 代理直观地操作桌面应用。
- 开发人员使用 Claude 或 Cursor 进行端到端桌面测试。
- 需要高保真 UI 无自动化与低 Token 开销的人。
该服务器为 Windows 桌面用户提供了强大的控制和低 Token 开销。其原生 Rust 引擎和敏锐的安全措施(如自动防护和故障安全)非常适合在有监督的自动化场景中使用。注意仅支持 Windows,且自动化代理的固有风险需要谨慎。
最强项 · 文档质量 12/20 最弱项 · 维护活跃度 7/20
静态评测 · 未实际运行收录于 2026-09-08
查看 FMRS 评分方法 →运行环境:Node.js v20+ · 预编译二进制
GITHUB_TOKEN
GitHub 个人访问令牌(github.com/settings/tokens),共享网络下避免每小时 60 次的匿名限流,可选。
GH_TOKEN
同 GITHUB_TOKEN 的别名,可选。
DESKTOP_TOUCH_AUTO_GUARD
设为 '0' 关闭自动动作防护,可选。
DESKTOP_TOUCH_PERCEPTION_RESOURCES
设为 '1' 启用 MCP 感知资源,可选。
DESKTOP_TOUCH_PERCEPTION_IDLE_MS
WinEvent 旁路进程进入休眠前的空闲毫秒数,默认 60000。
DESKTOP_TOUCH_PERCEPTION_DORMANCY_DISABLE
设为 '1' 让 WinEvent 旁路进程始终运行,可选。
DESKTOP_TOUCH_DIAGNOSTIC_LOG_DISABLE
设为 '1' 关闭 JSONL 诊断日志,可选。
DESKTOP_TOUCH_DIAGNOSTIC_LOG_PATH
覆盖诊断日志的保存路径,可选。
DESKTOP_TOUCH_DIAGNOSTIC_LOG_MAX_BYTES
诊断日志滚动大小阈值,默认 64 MiB,可选。
DESKTOP_TOUCH_RESOLVE_LOG_RAW
设为 '1' 在诊断日志中明文记录窗口标题(默认哈希记录),可选。
DESKTOP_TOUCH_MCP_HOME
覆盖运行时缓存根目录,可选。
DESKTOP_TOUCH_MCP_ALLOW_UNVERIFIED
设为 '1' 跳过运行时完整性校验,仅用于源码开发,可选。
DESKTOP_TOUCH_DOCK_TITLE
启动时自动停靠的目标窗口标题,设 '@parent' 自动定位宿主终端,可选。
DESKTOP_TOUCH_DOCK_CORNER
停靠角落,默认 bottom-right,可选。
DESKTOP_TOUCH_DOCK_WIDTH
停靠窗口宽度(像素或百分比),默认 480,可选。
DESKTOP_TOUCH_DOCK_HEIGHT
停靠窗口高度,默认 360,可选。
DESKTOP_TOUCH_DOCK_PIN
是否置顶,默认 true,可选。
DESKTOP_TOUCH_DOCK_MONITOR
停靠目标显示器,默认主显示器,可选。
DESKTOP_TOUCH_DOCK_SCALE_DPI
设为 true 时按 DPI 缩放停靠尺寸,可选。
DESKTOP_TOUCH_DOCK_MARGIN
屏幕边缘留白像素,默认 8,可选。
DESKTOP_TOUCH_DOCK_TIMEOUT_MS
等待目标窗口出现的最长毫秒数,默认 5000,可选。
DESKTOP_TOUCH_SCREENSHOTS_DIR
指定截图缓存目录,可选。
DESKTOP_TOUCH_SCREENSHOT_MAX_COUNT
截图缓存最大数量,默认 200,可选。
DESKTOP_TOUCH_SCREENSHOT_MAX_BYTES
截图缓存总大小上限,默认 256 MiB,可选。
DESKTOP_TOUCH_SCREENSHOT_MAX_AGE_MS
超过该毫秒数的截图被丢弃(默认关闭),可选。
DESKTOP_TOUCH_SCREENSHOT_AUTOPRUNE
自动修剪缓存,默认 on,可选。
DESKTOP_TOUCH_SCREENSHOT_MIN_EVICT_AGE_MS
新截图最短保留毫秒数,默认 60000,可选。
DESKTOP_TOUCH_CAPTURE_BACKEND
诊断用截图后端覆盖,设为 nutjs 强制旧后端,可选。
DESKTOP_TOUCH_FAILSAFE_HOLD_MS
紧急停止的鼠标停留毫秒数,默认 500,可选。
DESKTOP_TOUCH_MOUSE_SPEED
鼠标移动默认速度(像素/秒),默认 1500,可选。
DESKTOP_TOUCH_FORCE_FOCUS
设为 '1' 使 forceFocus 默认开启,可选。
DESKTOP_TOUCH_DISABLE_KEY_LOCKER
设为 '1' 禁用 Key Locker 凭据自动填充,可选。
DESKTOP_TOUCH_DISABLE_FUKUWARAI_V2
设为 '1' 隐藏 desktop_discover/desktop_act(V2 关闭开关),可选。
DESKTOP_TOUCH_ALLOWLIST
指向 workspace_launch 可执行文件白名单 JSON 的路径,可选。
npx -y @harusame64/desktop-touch-mcp。chrome.exe --remote-debugging-port=9222 --user-data-dir=C:\tmp\cdp。npx -y @harusame64/desktop-touch-mcp --http,默认端口 23847。{
"mcpServers": {
"desktop-touch": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@harusame64/desktop-touch-mcp"
]
}
}
}
以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。
{
"servers": {
"desktop-touch": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@harusame64/desktop-touch-mcp"
]
}
}
}
写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。
claude mcp add desktop-touch -- npx -y @harusame64/desktop-touch-mcp
在终端运行;先把 <…> 占位符换成你自己的值。
启动 Claude CLI 后,在工具列表中应能看到 desktop_discover、screenshot、server_status 等 32 个工具;调用 server_status 可确认原生 Rust 引擎健康状态,或直接让 AI 执行“截图并描述我的桌面”来验证连接。
连接成功后,可以直接对 AI 助手这样说:
没有匹配的工具
依据项目文档列出,未经本站实测。
Desktop Touch MCP 是一款用于 Windows 10/11 的计算使用 MCP 服务器。它提供 32 个工具,支持屏幕截图、UI 自动化、Chrome DevTools 协议、键盘/鼠标输入和终端控制。核心设计采用语义化的「发现-执行」机制(返回实体和租约而非像素坐标),并通过每次操作的感知守卫来避免误触窗口。底层使用原生 Rust 引擎(UIA 聚焦查询仅需 2 毫秒),并拥有透明的 PowerShell 回退。包含 Key Locker 功能,可安全地自动填充 SSH/sudo 凭据。与 Claude、Cursor 等 MCP 客户端兼容。该服务器以 MIT 许可证开源。
Upstash 官方维护,为 AI 编码助手提供实时更新的第三方库文档
基于 AI 的 NPM 包分析 MCP 服务器
为 AI 编码代理提供预算、验证与回滚的治理控制层
GitHub 官方 MCP Server,用自然语言管理仓库、Issue、PR 与工作流
源版本 4368a8f91d5a 数据同步于 2026-10-19 查看 FMRS 评分方法