项目简介 该项目是一个专为Windows系统设计的MCP(Model Context Protocol)服务器。它通过JSON-RPC协议与AI代理或其他MCP客户端通信,允许这些客户端获取Windows系统的各种诊断信息,执行系统管理操作。功能涵盖系统健康状况、蓝屏事件(BSOD)检测、关机分析、应用崩溃监控、系统稳定性评估、硬件状态监控(温度、风扇、硬盘SMART)、内存健康、磁盘使用、事件日志深度分析、注册表搜索、启动项分析、系统组件扫描、安全风险评估以及进程与应用管理等。
主要功能点
- 全面系统诊断: 分析Windows事件日志,识别崩溃、关机、启动等关键事件,并评估系统稳定性。
- 硬件健康监控: 实时获取CPU/GPU温度、风扇转速、硬盘SMART状态、内存健康信息,并支持磁盘使用和大文件/文件夹扫描。
- 事件日志深度分析: 强大的事件查看器工具,支持按关键词、事件ID、来源、日志名称和时间范围搜索,并提供安全分析和错误模式检测。
- 注册表诊断: 搜索注册表、分析启动项、扫描系统组件、检测孤立注册表项、评估注册表健康度并扫描安全风险。
- 进程与应用管理: 列出、终止和启动进程,以及列出已安装的应用程序。
- 权限与环境检查: 提供使用指南,检查管理员权限、PowerShell执行策略和系统环境,确保诊断工具正常运行。
安装步骤
- 系统要求:
- Windows 10/11 或 Windows Server
- Node.js 18+
- PowerShell 5.1+ (Windows内置)
- 管理员权限 (建议,以获得完整功能)
- PowerShell执行策略需允许脚本运行
- 克隆或下载仓库文件:
在您希望安装服务器的目录中执行以下命令:
mkdir windows-diagnostics-mcp cd windows-diagnostics-mcp # 将仓库文件下载到此目录 - 安装依赖:
进入 'windows-diagnostics-mcp' 目录,安装Node.js依赖:
npm install - 配置PowerShell执行策略:
如果尚未配置,请在PowerShell中执行以下命令以允许脚本运行:
(如果您需要系统范围的访问,请以管理员身份运行 PowerShell 并执行 'Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine')Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser - 构建服务器:
这将在 'build' 目录下生成可执行的JavaScript文件。npm run build
服务器配置 (供MCP客户端使用) 将以下JSON配置添加到您的MCP客户端(例如,Claude Desktop的 'claude_desktop_config.json' 文件)中。请务必将 'command' 字段中的路径替换为您的服务器安装路径。
{ "mcpServers": { "windows-diagnostics": { "command": "node", "args": ["C:\\path\\to\\your\\windows-diagnostics-mcp\\build\\index.js"], "env": { "NODE_ENV": "production" }, "description": "提供Windows系统诊断、硬件监控、事件日志和注册表分析功能,支持AI代理进行系统故障排查和性能优化。" } } }
配置参数说明:
- '"windows-diagnostics"': 这是您为该MCP服务器定义的唯一名称。
- '"command": "node"': 启动服务器的命令,这里是Node.js运行时。
- '"args": ["C:\path\to\your\windows-diagnostics-mcp\build\index.js"]': 传递给Node.js命令的参数,指定服务器的入口文件路径。请务必将 'C:\path\to\your\windows-diagnostics-mcp' 替换为您的实际安装路径。
- '"env": {"NODE_ENV": "production"}': 设置环境变量,这里是生产环境。
- '"description"': 服务器功能的简要描述,有助于客户端识别和使用。
基本使用方法 一旦MCP客户端配置并连接到此服务器,您可以通过自然语言向AI代理发出指令,调用服务器提供的工具:
- 检查系统稳定性: "分析我的Windows系统稳定性" "检查过去一周内是否有系统崩溃"
- 硬件监控: "监控我的硬件健康状况,包括温度和风扇速度" "检查我的硬盘SMART状态"
- 事件日志查询: "搜索事件查看器中所有关于'错误'的事件" "显示最近的蓝屏死机(BSOD)事件" "查找过去24小时内所有关键级别的事件"
- 注册表诊断: "在注册表中搜索'Adobe'相关的条目" "分析我的开机启动项是否有可疑程序" "扫描注册表是否存在安全风险"
- 进程与应用管理: "列出所有正在运行的进程" "杀死PID为1234的进程" "列出所有已安装的应用程序"
- 获取使用指南: "提供诊断工具的使用指南并检查管理员权限"
信息
分类
桌面与硬件