setup-windows-mcp

Installation
SKILL.md

安装 Windows-MCP(新机器配置指南)

这个 skill 解决什么

Windows-MCP(windows-mcp PyPI 包)让 agent 直接操作 Windows 桌面:截屏、鼠标点击、键盘输入、UI 元素树、窗口管理。它靠 uvx 运行——不需要 clone 源码,uvx 自动从 PyPI 拉包。

新机器上配它的坑不在 MCP 本身,而在三件事:

  1. uv 没装 → uvx 命令不存在,注册了也连不上。
  2. 国内网络 → astral.sh 官方安装脚本可能超时;uvx 首次拉 windows-mcp 的 90+ 依赖包走 PyPI,国内同样可能超时。
  3. PATH 分裂 → Git Bash、PowerShell、cmd 的 PATH 可能不一致,agent 在 Git Bash 里找不到 uvx(本机经验:winget/uvx 都出现过这种情况)。注册 MCP 时用 uvx.exe 全路径最稳。

总原则

  • 不需要 clone Windows-MCP 源码仓库——uvx 直接从 PyPI 运行,clone 只在改源码时才需要。
  • 注册用 uvx 全路径,不要裸写 uvx——规避各终端 PATH 不一致。
  • 镜像设成 Windows 用户级,不要只写 ~/.bashrc——uvx 是 Windows 程序,PowerShell/cmd 读不到 bash 配置。

Installs
13
Repository
shyxin/skills
GitHub Stars
4
First Seen
6 days ago