Windows-MCP.Net

MCP开发工具

提供方 shuyu-labs · 包名 windows-mcp.net

开发工具 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

A .NET-based Windows desktop automation MCP (Model Context Protocol) server that provides AI assistants with the ability to interact with the Windows

一句话选型结论

按资料字段整理

Windows-MCP.Net 属于开发工具类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 227 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

windows-mcp.net mcp ocr tool windows

支持客户端

适用场景

windows-mcp.netmcpocr

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
git clone https://github.com/shuyu-labs/Windows-MCP.Net && cd windows-mcp.net

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Windows-MCP.Net当前 未标注 stdio · 本地进程 本地部署 有 2026-04-12
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方shuyu-labs上游标注的维护方 shuyu-labs
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时windows-mcp.net · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-12上游最后核验时间

详细介绍

17.4 KB
来自项目仓库与上游目录的原文,未做删改

Windows MCP.Net

English | 中文

一个基于 .NET 的 Windows 桌面自动化 MCP (Model Context Protocol) 服务器,为 AI 助手提供与 Windows 桌面环境交互的能力。

📋 目录

  • 功能特性
  • 使用场景
  • 演示截图
  • 技术栈
  • API文档
  • 项目结构
  • 功能扩展建议
  • 配置
  • 贡献指南
  • 更新日志
  • 支持

🚀 快速开始

前置要求

  • Windows 操作系统
  • .NET 10.0 Runtime 或更高版本

重要提示: 本项目需要 .NET 10 才能运行,请先确保你的本地安装了 .NET 10。如果尚未安装,请访问 .NET 10 下载页面 进行下载和安装。

1. MCP 客户端配置

在您的 MCP 客户端配置中添加以下配置:

使用全局安装的工具(推荐)```json

{
"mcpServers": {
"WindowsMCP.Net": {
"type": "stdio",
"command": "dnx",
"args": ["WindowsMCP.Net@", "--yes"],
"env": {}
}
}
}


#### 使用项目源码直接运行(开发模式)

**方式一:工作区配置**

在项目根目录创建 `.vscode/mcp.json` 文件:```json
{
  "mcpServers": {
    "Windows-MCP.Net-Dev": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "src/Windows-MCP.Net.csproj"],
      "cwd": "${workspaceFolder}",
      "env": {}
    }
  }
}

方式二:用户配置

通过VS Code命令面板运行 MCP: Open User Configuration,添加:```json
{
"mcpServers": {
"Windows-MCP.Net-Local": {
"type": "stdio",
"command": "dotnet",
"args": ["run", "--project", "src/Windows-MCP.Net.csproj"],
"env": {}
}
}
}


> **注意**: 使用项目源码方式便于开发调试,修改代码后无需重新安装即可生效。VS Code 1.102+ 版本支持MCP服务器的自动发现和管理。

### 2. 安装和运行

#### 方式一:全局安装(推荐)```bash
dotnet tool install --global WindowsMCP.Net

方式二:从源码运行```bash

克隆仓库

git clone https://github.com/AIDotNet/Windows-MCP.Net.git
cd Windows-MCP.Net

构建项目

dotnet build

运行项目

dotnet run --project src/Windows-MCP.Net.csproj


### 3. 开始使用
配置完成后,重启您的MCP客户端,即可开始使用Windows桌面自动化功能!

## 🚀 功能特性

### 核心功能
- **应用程序启动**: 通过名称从开始菜单启动应用程序
- **PowerShell 集成**: 执行 PowerShell 命令并返回结果
- **桌面状态捕获**: 获取当前桌面状态,包括活动应用、UI 元素等
- **剪贴板操作**: 复制和粘贴文本内容
- **鼠标操作**: 点击、拖拽、移动鼠标光标
- **键盘操作**: 文本输入、按键操作、快捷键组合
- **窗口管理**: 调整窗口大小、位置,切换应用程序
- **滚动操作**: 在指定坐标进行滚动操作
- **网页抓取**: 获取网页内容并转换为 Markdown 格式
- **浏览器操作**: 在默认浏览器中打开指定URL
- **截图功能**: 截取屏幕并保存到临时目录
- **文件系统操作**: 文件和目录的创建、读取、写入、复制、移动、删除等操作
- **OCR文字识别**: 从屏幕或指定区域提取文字,查找文字位置
- **系统控制**: 调节屏幕亮度、系统音量、屏幕分辨率等系统设置
- **等待控制**: 在操作间添加延迟

### 支持的工具

## Desktop 桌面操作工具

| 工具名称 | 功能描述 |
|---------|----------|
| **LaunchTool** | 从开始菜单启动应用程序 |
| **PowershellTool** | 执行 PowerShell 命令并返回状态码 |
| **StateTool** | 捕获桌面状态信息,包括应用程序和UI元素 |
| **ClipboardTool** | 剪贴板复制和粘贴操作 |
| **ClickTool** | 鼠标点击操作(支持左键、右键、中键,单击、双击、三击) |
| **TypeTool** | 在指定坐标输入文本,支持清除和回车 |
| **ResizeTool** | 调整窗口大小和位置 |
| **SwitchTool** | 切换到指定应用程序窗口 |
| **ScrollTool** | 在指定坐标或当前鼠标位置滚动 |
| **DragTool** | 从源坐标拖拽到目标坐标 |
| **MoveTool** | 移动鼠标光标到指定坐标 |
| **ShortcutTool** | 执行键盘快捷键组合 |
| **KeyTool** | 按下单个键盘按键 |
| **WaitTool** | 暂停执行指定秒数 |
| **ScrapeTool** | 抓取网页内容并转换为Markdown格式 |
| **ScreenshotTool** | 截取屏幕并保存到临时目录,返回图片路径 |
| **OpenBrowserTool** | 在默认浏览器中打开指定URL |

## FileSystem 文件系统工具

| 工具名称 | 功能描述 |
|---------|----------|
| **ReadFileTool** | 读取指定文件的内容 |
| **WriteFileTool** | 向文件写入内容 |
| **CreateFileTool** | 创建新文件并写入指定内容 |
| **CopyFileTool** | 复制文件到指定位置 |
| **MoveFileTool** | 移动或重命名文件 |
| **DeleteFileTool** | 删除指定文件 |
| **GetFileInfoTool** | 获取文件信息(大小、创建时间等) |
| **ListDirectoryTool** | 列出目录中的文件和子目录 |
| **CreateDirectoryTool** | 创建新目录 |
| **DeleteDirectoryTool** | 删除目录及其内容 |
| **SearchFilesTool** | 在指定目录中搜索文件 |

## OCR 图像识别工具

| 工具名称 | 功能描述 |
|---------|----------|
| **ExtractTextFromScreenTool** | 使用OCR从整个屏幕提取文字 |
| **ExtractTextFromRegionTool** | 使用OCR从屏幕指定区域提取文字 |
| **FindTextOnScreenTool** | 使用OCR在屏幕上查找指定文字 |
| **GetTextCoordinatesTool** | 获取屏幕上文字的坐标位置 |
| **ExtractTextFromFileTool** | 使用OCR从图像文件中提取文字 |

## UI元素识别工具

| 工具名称 | 功能描述 |
|---------|----------|
| **FindElementByTextTool** | 通过文本内容查找UI元素 |
| **FindElementByClassNameTool** | 通过类名查找UI元素 |
| **FindElementByAutomationIdTool** | 通过自动化ID查找UI元素 |
| **GetElementPropertiesTool** | 获取指定坐标元素的属性信息 |
| **WaitForElementTool** | 等待指定元素出现在界面上 |

## SystemControl 系统控制工具

| 工具名称 | 功能描述 |
|---------|----------|
| **BrightnessTool** | 调节屏幕亮度,支持增减和设置具体百分比 |
| **VolumeTool** | 调节系统音量,支持增减和设置具体百分比 |
| **ResolutionTool** | 设置屏幕分辨率(高、中、低三档) |

## 💡 使用场景

### 🤖 AI助手桌面自动化
- **智能客服机器人**: AI助手可以自动操作Windows应用程序,帮助用户完成复杂的桌面任务
- **语音助手集成**: 结合语音识别,通过语音指令控制桌面应用程序
- **智能办公助手**: AI助手自动处理日常办公任务,如文档整理、邮件发送等

### 📊 办公自动化
- **数据录入自动化**: 自动从网页或文档中提取数据并录入到Excel或其他应用程序
- **报告生成**: 自动收集系统信息、截图,生成格式化的报告文档
- **批量文件处理**: 自动整理、重命名、分类大量文件和文档
- **邮件自动化**: 自动发送定期报告、通知邮件

### 🧪 软件测试与质量保证
- **UI自动化测试**: 模拟用户操作,自动测试桌面应用程序的功能
- **回归测试**: 自动执行重复性测试用例,确保软件质量
- **性能监控**: 自动收集应用程序性能数据,生成监控报告
- **Bug复现**: 自动重现用户报告的问题,辅助开发人员调试

### 🎯 业务流程自动化
- **客户服务**: 自动处理客户请求,更新CRM系统
- **订单处理**: 自动从多个渠道收集订单信息并录入系统
- **库存管理**: 自动更新库存数据,生成补货提醒
- **财务对账**: 自动对比不同系统的财务数据,标记差异

### 🔍 数据采集与分析
- **网页数据抓取**: 自动从多个网站收集产品价格、新闻等信息
- **竞品分析**: 定期收集竞争对手的产品信息和价格数据
- **市场调研**: 自动收集和整理市场数据,生成分析报告
- **社交媒体监控**: 监控品牌提及,自动收集用户反馈

### 🎮 游戏与娱乐
- **游戏辅助**: 自动执行重复性游戏任务(请遵守游戏规则)
- **直播助手**: 自动管理直播软件,切换场景,发送消息
- **媒体管理**: 自动整理音乐、视频文件,更新媒体库

### 🏥 医疗与健康
- **病历录入**: 自动将纸质病历转换为电子格式
- **医疗图像分析**: 结合OCR技术,自动提取医疗报告中的关键信息
- **预约管理**: 自动处理患者预约请求,更新医院管理系统

### 🏫 教育与培训
- **在线考试**: 自动批改选择题,生成成绩报告
- **课程管理**: 自动更新课程信息,发送通知给学生
- **学习进度跟踪**: 自动记录学生的学习活动,生成进度报告

### 🏭 制造业与物流
- **生产数据采集**: 自动从生产设备收集数据,更新ERP系统
- **质量检测**: 结合图像识别,自动检测产品质量
- **物流跟踪**: 自动更新货物状态,发送跟踪信息给客户

### 🔧 系统运维
- **服务器监控**: 自动检查服务器状态,生成监控报告
- **日志分析**: 自动分析系统日志,识别异常模式
- **备份管理**: 自动执行数据备份,验证备份完整性
- **软件部署**: 自动化软件安装和配置流程

## 📸 演示截图

### 文本输入演示
通过 TypeTool 在记事本中自动输入文本:

### 网页搜索演示
使用 ScrapeTool 打开并搜索网页内容:

### 📹 演示视频
完整的桌面自动化操作演示:

网页搜索演示

## 🛠️ 技术栈

- **.NET 10.0**: 基于最新的 .NET 框架
- **Model Context Protocol**: 使用 MCP 协议进行通信
- **Microsoft.Extensions.Hosting**: 应用程序托管框架
- **Serilog**: 结构化日志记录
- **HtmlAgilityPack**: HTML 解析和网页抓取
- **ReverseMarkdown**: HTML 到 Markdown 转换

## 🏗️ 项目结构```
src/
├── Windows-MCP.Net/         # 主项目
│   ├── .mcp/                # MCP 服务器配置
│   │   └── server.json      # 服务器配置文件
│   ├── Exceptions/          # 自定义异常类(待扩展)
│   ├── Interface/           # 服务接口定义
│   │   ├── IDesktopService.cs   # 桌面服务接口
│   │   ├── IFileSystemService.cs # 文件系统服务接口
│   │   └── IOcrService.cs       # OCR服务接口
│   ├── Models/              # 数据模型(待扩展)
│   ├── Prompts/             # 提示模板(待扩展)
│   ├── Services/            # 核心服务实现
│   │   ├── DesktopService.cs    # 桌面操作服务
│   │   ├── FileSystemService.cs # 文件系统服务
│   │   └── OcrService.cs        # OCR服务
│   ├── Tools/               # MCP 工具实现
│   │   ├── Desktop/             # 桌面操作工具
│   │   │   ├── ClickTool.cs         # 点击工具
│   │   │   ├── ClipboardTool.cs     # 剪贴板工具
│   │   │   ├── DragTool.cs          # 拖拽工具
│   │   │   ├── GetWindowInfoTool.cs # 窗口信息工具
│   │   │   ├── KeyTool.cs           # 按键工具
│   │   │   ├── LaunchTool.cs        # 启动应用工具
│   │   │   ├── MoveTool.cs          # 鼠标移动工具
│   │   │   ├── OpenBrowserTool.cs   # 浏览器打开工具
│   │   │   ├── PowershellTool.cs    # PowerShell执行工具
│   │   │   ├── ResizeTool.cs        # 窗口调整工具
│   │   │   ├── ScrapeTool.cs        # 网页抓取工具
│   │   │   ├── ScreenshotTool.cs    # 截图工具
│   │   │   ├── ScrollTool.cs        # 滚动工具
│   │   │   ├── ShortcutTool.cs      # 快捷键工具
│   │   │   ├── StateTool.cs         # 桌面状态工具
│   │   │   ├── SwitchTool.cs        # 应用切换工具
│   │   │   ├── TypeTool.cs          # 文本输入工具
│   │   │   ├── UIElementTool.cs     # UI元素操作工具
│   │   │   └── WaitTool.cs          # 等待工具
│   │   ├── FileSystem/          # 文件系统工具
│   │   │   ├── CopyFileTool.cs      # 文件复制工具
│   │   │   ├── CreateDirectoryTool.cs # 目录创建工具
│   │   │   ├── CreateFileTool.cs    # 文件创建工具
│   │   │   ├── DeleteDirectoryTool.cs # 目录删除工具
│   │   │   ├── DeleteFileTool.cs    # 文件删除工具
│   │   │   ├── GetFileInfoTool.cs   # 文件信息工具
│   │   │   ├── ListDirectoryTool.cs # 目录列表工具
│   │   │   ├── MoveFileTool.cs      # 文件移动工具
│   │   │   ├── ReadFileTool.cs      # 文件读取工具
│   │   │   ├── SearchFilesTool.cs   # 文件搜索工具
│   │   │   └── WriteFileTool.cs     # 文件写入工具
│   │   └── OCR/                 # OCR识别工具
│   │       ├── ExtractTextFromRegionTool.cs # 区域文本提取工具
│   │       ├── ExtractTextFromScreenTool.cs # 屏幕文本提取工具
│   │       ├── FindTextOnScreenTool.cs      # 屏幕文本查找工具
│   │       └── GetTextCoordinatesTool.cs    # 文本坐标获取工具
│   ├── Program.cs           # 程序入口点
│   └── Windows-MCP.Net.csproj   # 项目文件
└── Windows-MCP.Net.Test/    # 测试项目
    ├── DesktopToolsExtendedTest.cs  # 桌面工具扩展测试
    ├── FileSystemToolsExtendedTest.cs # 文件系统工具扩展测试
    ├── OCRToolsExtendedTest.cs      # OCR工具扩展测试
    ├── ToolTest.cs                  # 工具基础测试
    ├── UIElementToolTest.cs         # UI元素工具测试
    └── Windows-MCP.Net.Test.csproj  # 测试项目文件

🚧 功能扩展建议

计划中的功能

高级UI识别与交互

  • UI元素识别增强: 支持更多UI框架(WPF、WinForms、UWP)
  • 智能等待机制: 动态等待元素加载完成

文件系统操作增强

  • 高级文件搜索: 支持内容搜索、正则表达式匹配
  • 批量文件操作: 支持批量复制、移动、重命名
  • 文件监控: 实时监控文件系统变化

系统监控与性能分析

  • 系统资源监控: CPU、内存、磁盘、网络使用情况
  • 进程管理: 进程列表获取、性能监控、进程控制
  • 性能分析报告: 生成详细的系统性能报告

多媒体处理能力

  • 音频控制: 系统音量控制、音频设备管理
  • 图像处理: 图片缩放、裁剪、格式转换
  • 屏幕录制: 支持屏幕录制和回放

网络与通信功能

  • 网络诊断: Ping、端口扫描、连通性测试
  • HTTP客户端: 支持RESTful API调用
  • WiFi管理: WiFi网络扫描和连接管理

安全性与权限管理

  • 权限检查: 用户权限验证和管理
  • 数据加密: 敏感数据加密存储
  • 操作审计: 完整的操作日志和审计追踪

开发路线图

第一阶段(高优先级)- 核心功能增强

  • ✅ UI元素识别工具(已完成Windows API实现)
  • 🔄 文件管理工具增强
  • 📋 系统监控工具
  • 🔒 基础安全工具

第二阶段(中优先级)- 功能扩展

  • 📋 OCR文字识别优化
  • 📋 高级文件搜索
  • 📋 音频控制工具
  • 📋 网络诊断工具
  • 📋 Excel操作支持

第三阶段(低优先级)- 高级功能

  • 📋 图像处理工具
  • 📋 任务调度系统
  • 📋 数据库操作支持
  • 📋 宏录制与回放

🔧 配置

日志配置

项目使用 Serilog 进行日志记录,日志文件保存在 logs/ 目录下:

  • 控制台输出:实时日志显示
  • 文件输出:按天滚动,保留 31 天
  • 日志级别:Debug 及以上

环境变量

变量名 描述 默认值
ASPNETCORE_ENVIRONMENT 运行环境 Production

📝 许可证

本项目基于 MIT 许可证开源。详情请参阅 LICENSE 文件。

🔗 相关链接

  • Model Context Protocol
  • .NET 文档
  • Windows API 文档

🤝 贡献指南

我们欢迎社区贡献!如果您想为项目做出贡献,请遵循以下步骤:

开发环境设置

  1. 克隆仓库bash git clone https://github.com/AIDotNet/Windows-MCP.Net.git cd Windows-MCP.Net

  2. 安装依赖bash dotnet restore

  3. 运行测试bash dotnet test

  4. 构建项目bash dotnet build

贡献流程

  1. Fork 本仓库
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 创建 Pull Request

代码规范

  • 遵循 C# 编码规范
  • 为新功能添加单元测试
  • 更新相关文档
  • 确保所有测试通过

问题报告

在报告问题时,请提供:
- 操作系统版本
- .NET 版本
- 详细的错误信息
- 重现步骤

📞 支持

如果您遇到问题或有建议,请:

  1. 查看 Issues
  2. 创建新的 Issue
  3. 参与讨论
  4. 查看 Wiki 获取更多帮助

注意: 本工具需要适当的 Windows 权限来执行桌面自动化操作。请确保在受信任的环境中使用。

免责声明: 使用本工具进行自动化操作时,请遵守相关法律法规和软件使用协议。开发者不承担因误用工具而产生的任何责任。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Windows-MCP.Net 怎么安装?

在客户端按下面的安装命令接入:git clone https://github.com/shuyu-labs/Windows-MCP.Net && cd windows-mcp.net。对应的包名是 windows-mcp.net。装完在客户端配置里引用同一个包或端点。

Windows-MCP.Net 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Windows-MCP.Net 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Windows-MCP.Net 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

Windows-MCP.Net 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Windows-MCP.Net 能提供哪些能力?

资料显示能力标签包括 windows-mcp.net、mcp、ocr、tool、windows。具体工具清单以官方文档为准。

Windows-MCP.Net 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

Windows-MCP.Net 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-12。