Windows Management

Windows Management MCP Server

Windows Management MCP Server 是一款基于 Python 的模型上下文协议服务，用于本地 Windows 诊断、任务管理、清理、硬件检查、安全检查和管理工作流。

它通过标准输入/输出提供 96 个工具，面向 Claude Desktop、Cursor、VS Code 扩展宿主以及其他兼容 MCP 的客户端等本地助手。

重要提示：此服务以启动它的用户帐户权限运行。多个工具可以更改系统状态、删除文件、编辑注册表、管理服务、安装更新或执行 PowerShell。请先使用只读工具和试运行工具，审核目标路径和命令后，再启用具有破坏性的操作。

演示

观看演示：https://youtu.be/1GNk_GYYkww

功能

• 任务管理器：CPU、GPU、内存、磁盘使用情况、占用资源最多的进程、进程树、进程详情、挂起/恢复/终止进程。
• 存储清理：磁盘使用情况、最大文件夹/文件、重复项检测、旧文件、媒体发现、回收站删除、临时文件清理。
• 硬件和驱动程序：GPU 详情、NVIDIA nvidia-smi 探测、显示配置、已安装的驱动程序、有问题的设备、可更新的驱动程序。
• Windows 安全：Defender 状态/扫描、防火墙规则、BitLocker、安全启动、UAC、Windows Update 状态。
• 系统管理：服务、启动应用、计划任务、事件日志、崩溃诊断、还原点。
• 网络诊断：接口、活动套接字、侦听端口、防火墙关联、ping 延迟。
• 开发环境：Python/Node 探测、环境变量、常用开发端口。
• Shell 助手：打开/选中 Explorer 项目、屏幕截图、剪贴板、可见窗口。
• 外围设备和虚拟化：打印机、打印队列、音频、蓝牙、WSL、Hyper-V、可选 Windows 功能。

完整的工具目录请参见 docs/TOOLS.md。

要求

• Windows 10/11 或装有 PowerShell 的 Windows Server。
• Python 3.10 或更高版本。
• 某些工具需要管理员权限，或需要并非每台机器都安装的 Windows 功能/模块。
• 可选的供应商数据（例如 NVIDIA GPU 遥测数据）需要 PATH 中提供 nvidia-smi 等供应商工具。

安装

从 PyPI 安装：

pip install windows-management-mcp-server

创建虚拟环境并以可编辑模式安装软件包：

python -m venv venv
.\venv\Scripts\Activate.ps1
pip install -e .

这两种安装方式都会在当前活动环境中注册 windows-mcp-server 命令。

MCP 客户端配置

对于可以启动标准输入/输出 MCP 服务的客户端，请使用：

{
  "mcpServers": {
    "windows-management": {
      "command": "windows-mcp-server",
      "args": []
    }
  }
}

如果命令不在 PATH 中，请直接指定本地虚拟环境：

{
  "mcpServers": {
    "windows-management": {
      "command": "C:\\path\\to\\WindowsMCPServer\\venv\\Scripts\\python.exe",
      "args": ["-m", "windows_mcp_server.server"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\WindowsMCPServer"
      }
    }
  }
}

本地运行

windows-mcp-server

或者：

python -m windows_mcp_server.server

此服务使用标准输入/输出传输，通常由 MCP 客户端启动，而不是以交互方式运行。

VS Code 扩展

vscode-extension/ 文件夹包含一个小型 VS Code 扩展。它会优先从仓库本地虚拟环境启动此 MCP 服务，若失败则使用全局 windows-mcp-server。

cd vscode-extension
npm install
npm run compile

在 VS Code 中打开 vscode-extension/ 并按 F5，即可启动扩展开发主机。

安全模型

工具有意分为只读、较安全的变更和高风险变更几类。

• 优先使用报告工具：disk_cleanup_report、get_security_status、get_windows_update_status、list_scheduled_tasks、get_process_details。
• 优先使用安全删除方式：safe_delete_to_recycle_bin、safe_delete_many_to_recycle_bin，以及设置 dry_run=true 的 safe_delete_by_pattern。
• 请谨慎使用以下高风险工具：execute_powershell、注册表写入/删除、永久删除文件、更改服务、安装更新、终止进程、创建还原点。

在向你不完全信任的助手开放此服务之前，请参阅 docs/SECURITY_MODEL.md。

开发

对 Python 软件包进行编译检查：

.\venv\Scripts\python.exe -m compileall windows_mcp_server

检查已注册的工具数量：

.\venv\Scripts\python.exe -c "from windows_mcp_server.registry import register_all_tools, registered_tools; Dummy=type('Dummy',(),{'tool':lambda self: (lambda f:f)}); register_all_tools(Dummy()); print(len(registered_tools))"

编译 VS Code 扩展：

cd vscode-extension
npm run compile

仓库结构

windows_mcp_server/        Python MCP server package
windows_mcp_server/tools/  Tool modules grouped by Windows domain
vscode-extension/          Optional VS Code extension wrapper
docs/                      Tool catalog, security model, publishing guide
server.json                MCP Registry metadata
pyproject.toml             Python package metadata

发布

此仓库包含用于 MCP Registry 的 server.json 和兼容 PyPI 的软件包元数据。

完整的 GitHub、PyPI 和 MCP Registry 发布流程，请参阅 docs/PUBLISHING.md。

许可证

MIT。请参阅 LICENSE。