SL

shuyu-labs/windows-mcp.net

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

238 stars 37 forks 品質 67 トレンド 18MIT

shuyu-labs/windows-mcp.netは、https://github.com/shuyu-labs/windows-mcp.net.からインポートされたMCPサーバー候補です。

概要

shuyu-labs/windows-mcp.netは、https://github.com/shuyu-labs/windows-mcp.net.からインポートされたMCPサーバー候補です。

概要(AI 翻訳)

英語 |中文

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

📋 目录

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

🚀 快速开始

前置要求

  • Windows オペレーティング
  • .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": {} } } }