
Windows-MCP
让 AI 通过标准协议直接操控 Windows 桌面
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 11868
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Windows 操作系统(项目面向 Windows 桌面)
- 可用的 Python 环境(依赖由 pyproject.toml 管理,首次安装需要 1-2 分钟)
- 已安装 uv/uvx 命令(README 中所有运行命令均使用 uvx)
- 支持 MCP 的 AI 客户端,用于连接该服务器并调用工具
安装与启动步骤
-
1确认运行环境
在 Windows 上打开 PowerShell,确认 uvx 命令可用;若不可用需先安装 uv,再执行后续命令。
uvx --version -
2启动 MCP 服务
默认使用 stdio 传输,直接在终端运行即可;首次运行会安装依赖,可能较慢甚至超时。
uvx windows-mcp serve -
3使用 SSE 传输启动
如需通过 HTTP 方式连接,可指定 sse 传输并绑定本机地址与端口。
uvx windows-mcp serve --transport sse --host localhost --port 8000 -
4使用可流式 HTTP 启动
另一种 HTTP 传输方式,参数与 SSE 相同,仅传输类型不同。
uvx windows-mcp serve --transport streamable-http --host localhost --port 8000 -
5安装为后台任务
注册为后台任务,安装后立即启动并在每次登录时自动运行。
windows-mcp install
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
--transport | 否 | 指定服务传输方式,默认为 stdio | sse |
--host | 否 | HTTP 传输时绑定的主机地址 | localhost |
--port | 否 | HTTP 传输时监听的端口号 | 8000 |
如何确认成功
终端无报错并保持运行,MCP 客户端能连接并列出工具;首次运行若超时可忽略并重启一次。
常见问题
Q:首次启动很久甚至超时怎么办?
A:首次安装需在 pyproject.toml 中拉取依赖,可能耗时一两分钟;出现超时属正常现象,忽略并重新启动服务即可。
Q:默认用什么传输方式?
A:默认使用 stdio 传输,直接执行 uvx windows-mcp serve 即可;需要网络方式时再显式指定 sse 或 streamable-http。
Q:如何让服务开机自动运行?
A:执行 windows-mcp install,将其安装为后台任务,安装后立即启动并在每次登录时自动运行。
Q:MCP 客户端如何接入?
A:启动服务后,在支持 MCP 的客户端中连接该服务器,即可发现并调用窗口管理、键鼠输入、截图等桌面工具。
注意事项
- 项目仅面向 Windows 桌面环境,其他系统无法使用其系统级操作能力。
- 首次运行会自动安装依赖,耗时较长,超时后重启即可。
- stdio 为默认传输方式,仅在需要 HTTP 接入时才指定 --transport 与端口。
- 服务具备系统级桌面操作能力,请仅在可信的本地环境中连接使用。
核心亮点
- 基于 MCP 标准协议暴露桌面工具,可被多种 AI 客户端直接接入,集成成本低
- 覆盖窗口管理、键鼠输入、截图、应用启动等多类桌面操作,能力面较完整
- Python 实现,代码可读性和二次开发门槛较低,便于按需扩展自定义工具
不足之处
- 强依赖 Windows 平台,无法跨平台使用
- 桌面自动化对系统权限、分辨率和窗口状态敏感,稳定性受环境影响较大
- 文档与社区生态仍在完善中,复杂场景的示例和最佳实践有限
适用场景
- 构建可自主操作本机软件的桌面 AI 助手
- 跨应用信息收集与整理类自动化流程原型
- 为 RPA 或智能体项目提供标准化桌面操作接口
替代项目
pywinauto、AutoHotkey、UI.Vision
上一篇:playwright-mcp
下一篇:mobile-mcp
同类项目推荐
x-cmd
开源
给 Shell 装上 AI 超能力,一条命令搞定云与自动化
Shell Superpowers for AI Agents.
blender-mcp
开源
用聊天让 LLM 直接操控 Blender 建模
Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···
workflow-builder-template
开源
拖拽连线搭 AI 工作流,快速做出自动化原型
Visual AI workflow automation platform
flow-like
开源
拖拽搭 AI 工作流,强类型不炸线,Rust 跑得快
Flow-Like: Strongly Typed Enterprise Scale Workflows. Built for scalability, speed, ···
maestro
开源
Netflix 出品,大规模工作流编排,搞定复杂数据管道
Maestro: Netflix’s Workflow Orchestrator
camofox-browser
开源
给AI智能体一个隐形浏览器,轻松绕过反爬检测。
Anti-detection browser server for AI agents — REST API wrapping Camoufox engine wit···
workflowbuilder
开源
拖拽搭工作流,嵌入你的产品,后端随便换
Workflow orchestration framework for your product, open source: a white-label React ···
nx
开源
Monorepo 构建提速,CI 自动修复失败 PR
The Monorepo Platform that amplifies both developers and AI agents. Nx optimizes you···
tiaportal-mcp
开源
在 VS Code 里用 Copilot 直接读写 TIA Portal 项目
A MCP server for Siemens TIA Portal