HS Knowledge Vault

windows-mcp

3分钟阅读

env/windows-mcp

Windows 桌面自动化 MCP

Windows 桌面 MCP server 已安装并接入 Hermes gateway。下一次 user turn 起，agent 可见 18 个 mcp_windows_* 工具（截图、鼠标键盘、shell、文件、剪贴板、注册表、toast、抓网页等）。

安装时间线

  • 2026-06-02: 由 Reasonix CLI 安装 windows-mcp 包到 IDA PC 本地
  • 2026-06-02 22:15: Telegram agent（session 20260602_215957_7513f7bc）验证并写入 ~/.hermes/config.yaml 的 mcp_servers.windows 块（第 485–490 行），不需要重启 gateway

配置位置

  • Config 文件: C:\Users\IDA\.hermes\config.yaml
  • 配置块: mcp_servers.windows
  • 配置行: 第 485–490 行
  • Backups:
    • config.yaml.bak-20260602-221322
    • config.yaml.bak-pre-mcp-20260602-221505

关键启动参数

  • command: venv 绝对路径（/d/hermes-agent/venv/Scripts/python.exe）
  • args: ["-m", "windows_mcp", "serve"]
  • 必须用 venv 绝对路径 —— 直接用 python 在 PATH 里会失败

可用工具（18 个）

调用名带 mcp_windows_ 前缀：

工具能力
App启动 / 切换 / 调整窗口
PowerShell跑 PowerShell 命令
FileSystem文件读写 / 列表 / 搜索 / 复制 / 移动
Snapshot截屏 + UI 元素识别（AX tree）
Screenshot快速截屏（无 UI tree 解析）
Click / Double_Click / Right_Click鼠标点击（按坐标或 AX label）
Type键盘输入（可清空 / 按 Enter）
Scroll滚轮
Move鼠标移动 / 拖拽
Shortcut快捷键（ctrl+c / win+r 等）
Wait等待 N 秒
Scrape抓网页（curl + DOM 提取）
MultiSelect / MultiEdit多选 / 多字段编辑
Clipboard剪贴板读写
Process进程列表 / kill
NotificationWindows toast 通知
Registry注册表读写

验证方法

# 测试单个 server
/d/hermes-agent/venv/Scripts/hermes.exe mcp test windows
 
# 列出所有 enabled server
/d/hermes-agent/venv/Scripts/hermes.exe mcp list

预期输出（已验证 2026-06-02）:

  • Connected (5172ms), 18 tools discovered for windows
  • windows · all · ✓ enabled in mcp list

重要注意事项

配置改了不需要重启 gateway

client 进程按需重读 config（或 signal 触发）。改完 mcp_servers 块直接 hermes mcp test 验证即可。

venv 路径必须绝对

写 command 不能写 python / python3，必须写 venv 里的 python.exe 完整路径。原因：MCP subprocess 不继承 hermes agent 的 venv activation。

Windows 桌面 + 截图：登录状态依赖

如果 PC 锁屏或登出，Screenshot / Snapshot / 鼠标键盘工具会失败（无桌面会话）。需先 RDP / 物理登录。

参考

  • Skill: skills/mcp_native-mcp.md — 原生 MCP client 的配置与使用规范
  • Session: 20260602_215957_7513f7bc (Telegram, 2026-06-02 21:59:57) — 第一次验证 Windows MCP 可用
  • Reasonix 任务：负责实际安装 / 升级 windows-mcp Python 包

关系图谱