Windows-MCP

让 AI 通过标准协议直接操控 Windows 桌面

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 自动化工作流 🍴 复刻 1272 🐛 待处理 30 👀 关注 50
GitHub ↗
GitHub 星标 ★ 11868
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行部署

项目预览

Windows-MCP 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队CursorTouch
定价模式🏷️完全免费
价格说明开源免费,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai,desktop,mcp,tools,windows,windows-automation
GitHub 星标★ 11868
上线时间2025-05-13 00:00:00
代码更新2026-11-18
仓库体积12.8 MB
本站数据更新2026-11-19
维护状态活跃
收录时间2026-11-19
浏览次数0

项目介绍

Windows-MCP 是一个面向 Windows 桌面的 MCP(Model Context Protocol)服务器,用 Python 编写。它把本地 Windows 系统的桌面操作能力封装成标准化工具接口,让支持 MCP 的 AI 客户端或智能体能够调用系统级操作,例如窗口管理、键鼠输入、截图、应用启动、文件与剪贴板交互等,从而完成“让 AI 直接操作电脑”的自动化任务。项目解决的核心问题是:大模型本身无法直接控制操作系统,而传统脚本自动化又难以被 AI 动态编排。Windows-MCP 通过统一协议层把桌面动作暴露为可发现、可调用的工具,降低 AI 代理接入 Windows 自动化的门槛。其能力偏向通用桌面控制而非固定流程录制,适合构建桌面助手、RPA 原型、跨应用信息整理等场景。项目星标过万,属于该方向较受关注的开源实现。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 11868

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:命令行工具 5 步

环境要求

  • Windows 操作系统(项目面向 Windows 桌面)
  • 可用的 Python 环境(依赖由 pyproject.toml 管理,首次安装需要 1-2 分钟)
  • 已安装 uv/uvx 命令(README 中所有运行命令均使用 uvx)
  • 支持 MCP 的 AI 客户端,用于连接该服务器并调用工具

安装与启动步骤

  1. 1确认运行环境

    在 Windows 上打开 PowerShell,确认 uvx 命令可用;若不可用需先安装 uv,再执行后续命令。

    uvx --version
  2. 2启动 MCP 服务

    默认使用 stdio 传输,直接在终端运行即可;首次运行会安装依赖,可能较慢甚至超时。

    uvx windows-mcp serve
  3. 3使用 SSE 传输启动

    如需通过 HTTP 方式连接,可指定 sse 传输并绑定本机地址与端口。

    uvx windows-mcp serve --transport sse --host localhost --port 8000
  4. 4使用可流式 HTTP 启动

    另一种 HTTP 传输方式,参数与 SSE 相同,仅传输类型不同。

    uvx windows-mcp serve --transport streamable-http --host localhost --port 8000
  5. 5安装为后台任务

    注册为后台任务,安装后立即启动并在每次登录时自动运行。

    windows-mcp install

关键配置

配置项必填说明示例
--transport否指定服务传输方式,默认为 stdiosse
--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.

★ 4755 2026-09-12
blender-mcp 开源

用聊天让 LLM 直接操控 Blender 建模

Community plugin to control Blender 3D with any LLM of your choice. Not affiliated w···

★ 34887 2026-09-16
flow-like 开源

拖拽搭 AI 工作流,强类型不炸线,Rust 跑得快

Flow-Like: Strongly Typed Enterprise Scale Workflows. Built for scalability, speed, ···

★ 980 2026-09-16
maestro 开源

Netflix 出品,大规模工作流编排,搞定复杂数据管道

Maestro: Netflix’s Workflow Orchestrator

★ 3853 2026-08-09
camofox-browser 开源

给AI智能体一个隐形浏览器,轻松绕过反爬检测。

Anti-detection browser server for AI agents — REST API wrapping Camoufox engine wit···

★ 445 2026-08-09
workflowbuilder 开源

拖拽搭工作流,嵌入你的产品,后端随便换

Workflow orchestration framework for your product, open source: a white-label React ···

★ 447 2026-10-07
nx 开源

Monorepo 构建提速,CI 自动修复失败 PR

The Monorepo Platform that amplifies both developers and AI agents. Nx optimizes you···

★ 29474 2026-10-01
tiaportal-mcp 开源

在 VS Code 里用 Copilot 直接读写 TIA Portal 项目

A MCP server for Siemens TIA Portal

★ 142 2026-09-25