shuyu-labs/windows-mcp.net

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

236 stars 37 forks 품질 67 트렌드 18MIT

Repository Install

shuyu-labs/windows-mcp.net은 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

shuyu-labs/windows-mcp.net은 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

영어 | 中文

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

📋 目录

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

🚀 快速开始

前置要求

윈도우 操作系统
.NET 10.0 런타임 또는 더 높은 版本

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

1. MCP 客户端配置

귀하의 MCP 客户端配置中추가以下配置:

使用全局安装的工具（推荐）

使用项目源码直接运行（开发模式）

方式一：工作区配置

在项目根目录创建 .vscode/mcp.json 文件:

方式二：用户配置

通过VS Code명령面板运行 MCP: Open User Configuration,添加:

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

2. 安装和运行

方式一：全局安装（推荐）

方式二：从源码运行

3. 开始使用

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

🚀 功能特性

核心功能

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

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Windows MCP.Net

English | 中文

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

🚀 快速开始

前置要求

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

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

1. MCP 客户端配置

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

使用全局安装的工具（推荐）

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

使用项目源码直接运行（开发模式）

方式一：工作区配置

在项目根目录创建 .vscode/mcp.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，添加：

{
  "mcpServers": {
    "Windows-MCP.Net-Local": {
      "type": "stdio",
      "command": "dotnet",
      "args": ["run", "--project", "src/Windows-MCP.Net.csproj"],
      "env": {}
    }
  }
}

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

2. 安装和运行

方式一：全局安装（推荐）

dotnet tool install --global WindowsMCP.Net

方式二：从源码运行

# 克隆仓库
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 文件系统工具

| 工具名称 | 功能描述 |

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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