Windows-MCP 安装与使用全指南：让 AI 轻松操控你的电脑
Windows-MCP（Windows Model Context Protocol）作为一款能让 AI 大模型直接与 Windows 系统交互的开源工具，正在改变我们与电脑的互动方式。本文将详细介绍其安装步骤和使用方法，帮助你快速上手这款强大的工具。
一、安装前的准备工作
在开始安装 Windows-MCP 之前，请确保你的系统满足以下要求：
- 操作系统：Windows 7、8、10 或 11（32 位或 64 位均可）
- Python 环境：Python 3.13 及以上版本
- 包管理器：建议安装 UV（更快速的 Python 包管理工具）
- 额外工具：若使用 Claude 桌面版，需安装 DXT 工具
前置工具安装
首先安装 UV 包管理器（如果尚未安装）：
bash
pip install uv 如果计划使用 Claude 桌面版，还需要安装 DXT 工具：
bash
npm install -g @anthropic-ai/dxt 二、获取 Windows-MCP 源代码
- 打开命令提示符或 PowerShell
- 克隆项目仓库：
bash
git clone https://github.com/CursorTouch/Windows-MCP.git - 进入项目目录：
bash
cd Windows-MCP 如果你没有安装 Git，也可以直接从 GitHub 下载 ZIP 压缩包，然后解压到本地文件夹。
三、不同使用场景的安装方法
场景 1：配合 Claude 桌面版使用
这是最推荐的使用方式，操作简单且体验流畅：
- 在项目目录中，构建桌面扩展：
bash
npx @anthropic-ai/dxt pack - 等待命令执行完成，会生成一个
.dxt格式的扩展文件 - 打开 Claude 桌面版应用
- 点击右上角的设置图标（齿轮形状）
- 在设置菜单中，选择 "扩展" 选项
- 点击 "安装扩展" 按钮，浏览并选择刚才生成的
.dxt文件 - 安装完成后，Claude 会提示扩展已启用，此时 Windows-MCP 已准备就绪
场景 2：配合 Gemini CLI 使用
如果你更习惯使用命令行界面的 Gemini，可以按照以下步骤配置：
- 找到 Gemini 的配置文件，通常位于：
plaintext
%USERPROFILE%/.gemini/settings.json - 用文本编辑器打开该文件
- 在配置中添加以下内容（请替换路径为你的实际 Windows-MCP 目录）：
json
"mcpServers": { "windows-mcp": { "command": "uv", "args": [ "--directory", "C:/你的路径/Windows-MCP", // 替换为实际路径 "run", "main.py" ] } } - 保存文件并重启 Gemini CLI
四、基本使用方法
启动服务
无论使用哪种场景，首次使用时都需要启动 Windows-MCP 服务：
在项目目录中执行：
bash
uv run main.py 服务启动成功后，会显示类似以下的信息：
plaintext
Windows-MCP server started on port 5000 Waiting for connections... 向 AI 发送指令
现在你可以向已连接的 AI（Claude 或 Gemini）发送各种系统操作指令了，例如：
- "打开记事本，输入 'Hello Windows-MCP'"
- "调整当前窗口大小为 800x600 像素"
- "帮我打开计算器并计算 256 乘以 32"
- "捕获当前桌面状态并描述给我"
AI 会自动通过 Windows-MCP 将你的自然语言指令转换为实际的系统操作。
常用功能示例
- 启动应用："打开 Microsoft Edge 浏览器"
- 窗口操作："将浏览器窗口移动到屏幕右侧"
- 文本输入："在记事本中输入今天的待办事项"
- 系统命令："通过 PowerShell 查看当前目录文件"
- 截图操作："捕获当前窗口并保存到桌面"
五、高级配置与自定义
Windows-MCP 支持通过配置文件进行个性化设置，主要配置文件为项目目录下的config.json，你可以在这里：
- 修改默认端口号
- 设置操作超时时间
- 配置日志级别
- 添加自定义快捷键映射
- 调整 UI 元素识别精度
六、常见问题解决
- 服务启动失败：
- 检查 Python 版本是否符合要求
- 尝试重新安装依赖：
uv install
- AI 无法执行操作：
- 确认 Windows-MCP 服务是否正在运行
- 检查防火墙设置，确保端口未被阻止
- 中文应用识别问题：
- 在指令中使用应用的英文名称可能更可靠
- 可以在配置文件中添加应用名称映射
- 操作延迟过高：
- 关闭不必要的后台程序
- 降低屏幕分辨率或减少同时运行的应用
七、安全注意事项
- 由于 Windows-MCP 能直接操控系统，请勿在公共或不安全的环境中使用
- 避免向 AI 授予过高的系统权限
- 使用完毕后建议关闭服务，特别是在处理敏感信息时
- 定期更新项目到最新版本，以获取安全补丁
通过以上步骤，你已经可以顺利安装并使用 Windows-MCP 了。这款工具的强大之处在于它能让 AI 真正 "理解" 并 "操作" 你的电脑，将大大提升你的工作效率。随着项目的不断更新，未来还会有更多强大的功能加入，值得持续关注。
