Windows-MCP快速上手:如何在Claude Desktop中安装配置你的第一个AI助手
Windows-MCP是一款轻量级开源项目,作为MCP服务器架起了LLM与Windows操作系统之间的桥梁,能让AI助手实现文件导航、应用控制、UI交互、QA测试等多种任务。它具有轻量级、易安装的特点,能帮助用户快速在Claude Desktop中配置属于自己的AI助手。## 🌟 Windows-MCP的核心优势Windows-MCP之所以能成为Claude Desktop的理想AI助手
Windows-MCP快速上手:如何在Claude Desktop中安装配置你的第一个AI助手
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 uv或curl -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:从源代码安装
- 克隆仓库:
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工具列表,包含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的Type-Tool在记事本中输入关于大型语言模型的文本
或者让它帮你打开浏览器查询天气:
图:Claude使用Windows-MCP的工具打开浏览器并查询Kochi的天气
📝 注意事项
- 首次安装运行时可能会有延迟,这是正常现象,因为需要安装相关依赖。
- 如果遇到
spawn ENOENT错误,通常是因为Electron应用未继承PATH,需使用uv/uvx的完整绝对路径。 - Windows-MCP默认启用遥测功能,若要禁用,可在配置中添加环境变量
"ANONYMIZED_TELEMETRY": "false"。
通过以上步骤,你已经成功在Claude Desktop中安装配置了Windows-MCP AI助手。现在,你可以充分利用它的强大功能,让AI更好地协助你完成各种Windows操作任务!
更多推荐



所有评论(0)