Windows-MCP快速上手:如何在Claude Desktop中安装配置你的第一个AI助手

【免费下载链接】Windows-MCP Lightweight MCP Server for automating Windows OS in the easy way. 【免费下载链接】Windows-MCP 项目地址: https://gitcode.com/gh_mirrors/wi/Windows-MCP

Windows-MCP是一款轻量级开源项目,作为MCP服务器架起了LLM与Windows操作系统之间的桥梁,能让AI助手实现文件导航、应用控制、UI交互、QA测试等多种任务。它具有轻量级、易安装的特点,能帮助用户快速在Claude Desktop中配置属于自己的AI助手。

🌟 Windows-MCP的核心优势

Windows-MCP之所以能成为Claude Desktop的理想AI助手搭档,主要得益于其强大的功能特性:

  • 无缝Windows集成:可与Windows UI元素原生交互,实现打开应用、控制窗口、模拟用户输入等操作。
  • 兼容任意LLM:无需依赖传统计算机视觉技术或特定微调模型,能与任何LLM配合使用,降低了使用复杂度和设置时间。
  • 丰富的UI自动化工具集:包含用于基本键盘、鼠标操作以及捕获窗口/UI状态的工具。
  • 轻量级且开源:依赖项少,安装简单,完整源代码在MIT许可下可用。

📋 安装前的准备工作

在开始安装Windows-MCP之前,需要确保你的系统满足以下条件:

  • 操作系统为Windows 7、8/8.1、10或11。
  • 已安装Python 3.13及以上版本。
  • 安装UV包管理器,可通过pip install uvcurl -LsSf https://astral.sh/uv/install.sh | sh命令进行安装。
  • Windows默认语言为英语,若使用其他语言,需在MCP服务器中禁用“App-Tool”。

🚀 快速安装步骤

步骤1:安装Claude Desktop与MCPB

首先,安装Claude Desktop,然后打开终端,执行以下命令安装MCPB:

npm install -g @anthropic-ai/mcpb

步骤2:选择安装方式

Windows-MCP提供了两种安装方式,你可以根据自己的需求选择:

选项A:从PyPI安装(推荐)

使用uvx直接运行PyPI上的最新版本,无需克隆仓库。

选项B:从源代码安装
  1. 克隆仓库:
git clone https://gitcode.com/gh_mirrors/wi/Windows-MCP
cd Windows-MCP

步骤3:配置Claude Desktop

无论选择哪种安装方式,都需要配置Claude Desktop。添加以下内容到你的claude_desktop_config.json文件中:

对于选项A(PyPI安装):
{
  "mcpServers": {
    "windows-mcp": {
      "command": "uvx",
      "args": [
        "windows-mcp"
      ]
    }
  }
}
对于选项B(源代码安装):
{
  "mcpServers": {
    "windows-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "<path to the windows-mcp directory>",
        "run",
        "windows-mcp"
      ]
    }
  }
}

步骤4:处理特殊情况(Windows Store版Claude Desktop)

如果使用的是Windows Store版Claude Desktop(MSIX打包),配置文件位置有所不同,位于:%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

此时需要使用uv.exe的完整绝对路径,配置示例如下:

{
  "mcpServers": {
    "windows-mcp": {
      "command": "C:\\Users\\<user>\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\<user>\\AppData\\Local\\Packages\\Claude_pzs8sxrjxfjjc\\LocalCache\\Roaming\\Claude\\Claude Extensions\\ant.dir.cursortouch.windows-mcp",
        "run",
        "windows-mcp"
      ]
    }
  }
}

记得将<user>替换为你的用户名。可以通过在终端中运行where uv命令找到uv.exe的位置,常见位置是%USERPROFILE%\.local\bin\uv.exe。保存文件时需选择“UTF-8 without BOM”格式。

⚙️ 启动与验证安装

完成配置后,打开Claude Desktop。首次安装运行时,由于需要安装pyproject.toml中的依赖项,可能需要一两分钟时间。如果服务器首次运行超时,可忽略并重启。

成功启动后,你可以在Claude Desktop中看到Windows-MCP相关工具已可用。

Claude Desktop中Windows-MCP工具界面 图:Claude Desktop中显示的Windows-MCP工具列表,包含Launch-Tool、PowerShell-Tool等多种工具

🎯 开始使用Windows-MCP AI助手

安装配置完成后,你就可以开始使用Windows-MCP增强Claude Desktop的功能了。Windows-MCP提供了丰富的工具,如:

  • Click:在指定坐标点击屏幕
  • Type:在元素上输入文本(可选择清除现有文本)
  • Scroll:在窗口或特定区域垂直或水平滚动
  • Screenshot:快速捕获桌面截图
  • Shell:执行PowerShell命令
  • App:从开始菜单启动应用、调整窗口大小或移动窗口、切换应用等

例如,你可以让Claude Desktop使用Windows-MCP的工具自动打开记事本并输入文本:

Claude使用Windows-MCP工具操作记事本 图:Claude使用Windows-MCP的Type-Tool在记事本中输入关于大型语言模型的文本

或者让它帮你打开浏览器查询天气:

Claude使用Windows-MCP工具查询天气 图:Claude使用Windows-MCP的工具打开浏览器并查询Kochi的天气

📝 注意事项

  • 首次安装运行时可能会有延迟,这是正常现象,因为需要安装相关依赖。
  • 如果遇到spawn ENOENT错误,通常是因为Electron应用未继承PATH,需使用uv/uvx的完整绝对路径。
  • Windows-MCP默认启用遥测功能,若要禁用,可在配置中添加环境变量"ANONYMIZED_TELEMETRY": "false"

通过以上步骤,你已经成功在Claude Desktop中安装配置了Windows-MCP AI助手。现在,你可以充分利用它的强大功能,让AI更好地协助你完成各种Windows操作任务!

【免费下载链接】Windows-MCP Lightweight MCP Server for automating Windows OS in the easy way. 【免费下载链接】Windows-MCP 项目地址: https://gitcode.com/gh_mirrors/wi/Windows-MCP

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐