让AI帮你干活WindowsMCP安装和使用!

第一步:安装python

Python: 确保你的电脑安装了 Python (推荐 3.10+)。

第二步:安装python uv

指令:pip install uv

第三步:安装node qwen-code

node去官网下载最新的即可

npm install -g @qwen-code/qwen-code@latest

第四步:下载Windows-MCP

地址:CursorTouch/Windows-MCP: MCP Server for Computer Use in Windows

第五步:使用UV来实现安装项目的依赖

解压使用cmd打开

指令:uv sync

报错解决:

A:\卓面\Windows-MCP-main>uv sync’uv’ 不是内部或外部命令,也不是可运行的程序或批处理文件

(1):精准找到 uv 的可执行文件路径

根据 pip show uv 输出的 Location 字段(c:\users\XXXXX\appdata\roaming\python\python38\site-packages),uv.exe 一定在同级的 Scripts 目录下,所以最终需要添加的环境变量路径是

plaintext
c:\users\XXXXx\appdata\roaming\python\python38\Scripts

✅ 验证路径:复制上面的路径,粘贴到「文件资源管理器」地址栏,回车后如果能看到 uv.exe 文件,说明路径完全正确。

(2):添加路径到系统环境变量(Windows 通用)

  1. 快速打开环境变量设置:
    • 按下 Win + R 键,输入 sysdm.cpl,回车 → 切换到「高级」选项卡 → 点击「环境变量」;
  2. 编辑系统变量 Path
    • 在「系统变量」列表中找到 Path(注意不是「用户变量」的 Path,避免仅当前用户生效)→ 点击「编辑」;
    • 点击「新建」→ 粘贴第一步的路径(c:\users\XXXX\appdata\roaming\python\python38\Scripts)→ 连续点击「确定」保存所有窗口(一定要点到最外层窗口的确定,否则不生效);
  3. 关键操作:关闭当前所有命令行 / 终端窗口(环境变量修改后,已打开的终端不会刷新,必须重启)。

(3):验证并执行 uv sync

  1. 重新打开一个新的命令行,先切换到你的项目目录(如果没切换的话):
    cmd
    A:
    cd 卓面\Windows-MCP-main

  2. 先验证 uv 是否能被识别:
    cmd
    uv --version
    若输出 uv 0.9.13 (xxxx),说明环境变量配置成功;

  3. 再执行目标命令:
    cmd
    uv sync
    此时会正常下载项目依赖,不会再提示「不是内部或外部命令」。

补充:如果仍失败的排查技巧

  1. 再次确认环境变量路径是否正确(复制路径到文件资源管理器,必须能看到 uv.exe);

  2. 若还是提示找不到,尝试在命令行直接用完整路径执行 uv(验证文件是否存在):
    cmd
    c:\users\XXXXX\appdata\roaming\python\python38\Scripts\uv.exe sync
    若能正常运行,说明是环境变量没配置好,重新检查步骤 2;

  3. 若完整路径也提示「文件不存在」,可能是 uv 安装不完整,执行以下命令重新安装:
    cmd
    pip uninstall -y uv
    pip install uv --user
    安装后再去 Scripts 目录确认 uv.exe 是否存在。

本质还是「系统找不到 uv.exe 可执行文件」,只要把正确的 Scripts 路径添加到环境变量,重启终端就能解决~

第六步:启动WindowsMCP

指令:

uv run main.py

第七步:配置文件

导航到:r

%USERPROFILE%/.qwen/settings.json

win+r执行 %USERPROFILE%

若果没有:/.qwen/settings.json文件,创建该文件

将配置添加到windows-mcp settings.json中并保存

{
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "WindowsMCP的地址",
        "run",
        "main.py"
      ]
    }
  }
}

第八步:使用qianwen code启动

在终端输入:qwen