# Install dependencies
npm install
# Build
npm run build
# Run in MCP mode (Claude, Kiro, Cursor)
npm start
# Run with write actions enabled
npm run start:actions
# Run as HTTP server for local LLMs
npm run serve
# Check version and tool count
node dist/index.js --version
# List all available tools
node dist/index.js --list-toolsRelated MCP server: AETHER_01
添加到你的 MCP 客户端配置（Claude Desktop、Kiro、Cursor）：
{
"mcpServers": {
"winfolio": {
"command": "node",
"args": ["C:/path/to/winfolio-mcp/dist/index.js"]
}
}
}启用操作后：
{
"mcpServers": {
"winfolio": {
"command": "node",
"args": ["C:/path/to/winfolio-mcp/dist/index.js", "--allow-actions"]
}
}
}npm run serve
# Server starts on http://localhost:7890
# Custom port
node dist/index.js --serve --port=8080端点：
GET / — 服务器信息与工具列表
GET /v1/tools — 以 OpenAI 函数调用格式列出的工具
POST /v1/tools/:name — 直接调用工具
POST /v1/chat/completions — 兼容 OpenAI 的聊天，支持自动工具路由
工具 | 描述 |
| CPU、内存、运行时间、操作系统版本及健康建议 |
| CPU/内存占用最高的进程，并检测资源占用大户 |
| 监听端口，检测开发端口冲突 |
| Windows 服务健康状态，关键服务监控 |
| 最近的错误及通俗易懂的解释 |
| 磁盘空间分析及清理建议 |
| 开机启动程序及可安全禁用的建议 |
工具 | 描述 |
| 激活状态、版本、许可证类型 |
| 页面文件配置、提交内存、交换分析 |
| NTP 服务器、时钟偏差、W32Time 服务 |
| 分类的关键/错误事件（磁盘、驱动、网络等） |
工具 | 描述 |
| GPU 型号、显存、驱动版本、利用率 |
| 电量、健康百分比、循环次数、剩余时间 |
| CPU/系统温度，过热检测 |
| 内存插槽、速度、类型、升级潜力 |
| UEFI/BIOS 版本、安全启动、TPM 状态 |
| 显示器、分辨率、刷新率、缩放 |
工具 | 描述 |
| 适配器、IP、DNS、网关、公网 IP |
| 可见网络、信号强度、已保存的配置文件 |
| 按进程分组的 TCP 连接（netstat） |
| Hosts 条目及可疑重定向检测 |
| 已连接的 VPN，第三方适配器检测 |
| 系统代理、WPAD、环境变量代理 |
| 适配器链路速度、吞吐量统计 |
| 已配对设备、电池电量、连接状态 |
| 播放/录音设备、状态 |
工具 | 描述 |
| 按大小查找磁盘上最大的文件 |
| 查找浪费空间的相同文件（MD5 哈希） |
工具 | 描述 |
| 检测内存持续增长、句柄过多的进程 |
| 蓝屏小型转储、应用崩溃、崩溃频率 |
| 检查所有需要重启的标志 |
| 启动时间阶段、启动缓慢的项目 |
工具 | 描述 |
| 配置文件状态、规则数量、最近的阻止记录 |
| 实时保护、定义、威胁 |
| SMB 共享及权限审计 |
| 本地账户、管理员审计、密码期限 |
| 每个卷的驱动器加密状态 |
| DEP、ASLR、CFG、HVCI、Credential Guard |
| 遥测、广告 ID、位置、摄像头/麦克风 |
工具 | 描述 |
| 已安装的 SDK（Node、Python、.NET、Java、Go、Rust） |
| 有未提交/未推送更改的仓库 |
| 全局包，弃用检测 |
| 扩展，标记重量级/已弃用 |
| 密钥清单、口令审计、代理状态 |
| WSL VHD 大小、压缩建议 |
| 开发端口扫描（本地正在运行的内容） |
| .NET SDK/运行时版本、global.json 验证 |
| 容器、镜像、守护进程状态 |
| 发行版、版本、运行状态 |
| 程序及预装软件检测 |
| PATH 分析、关键环境变量 |
工具 | 描述 |
| 待安装更新、历史记录、自动更新健康状态 |
| 非系统任务、失败任务检测 |
| 可选功能（Hyper-V、WSL、IIS、Sandbox） |
| 启动项及启动影响评级 |
| 缺失/失败/过时的驱动程序 |
| 索引器状态、索引大小 |
| 即将过期/已过期的 SSL 证书 |
| 还原点、时间、创建触发条件 |
工具 | 描述 |
| 启动/关机事件、稳定性评分 |
| 快照并随时间比较系统指标 |
工具 | 描述 |
| 当前剪贴板、历史条目 |
| 最近访问的文件，支持搜索 |
| 当前电源计划、节流检测 |
工具 | 描述 |
| 配置文件加载时间、模块导入审计 |
| 自动启动服务、失败检测 |
工具 | 描述 |
| 已安装的字体，支持搜索 |
| 已连接的 USB 外设和驱动器 |
| S.M.A.R.T. 数据、磨损程度、驱动器故障预测 |
| 检测正在录屏/共享的软件 |
| CPU/内存/磁盘/网络/GPU 一体化快照 |
工具 | 描述 |
| 本地 Ollama 模型清单 |
| 生成完整的 Markdown 健康报告 |
--allow-actions）工具 | 描述 |
| 按 PID 或名称终止进程 |
| 重启/启动/停止 Windows 服务 |
| 终止占用端口的进程 |
| 删除临时文件以释放空间 |
| 清除 DNS 解析器缓存 |
| 永久删除回收站内容 |
| 切换 Windows 深色/浅色主题 |
| 计划系统重启 |
| 禁用启动程序 |
| 创建系统还原点 |
| 切换电源计划（平衡/高性能等） |
| 发送原生 Windows 通知 |
src/
index.ts — Entry point, CLI flags, MCP/HTTP transport selection
powershell.ts — AV-safe PowerShell executor (temp .ps1 files)
http-server.ts — Hono-based OpenAI-compatible HTTP server
tools/
registry.ts — Unified tool registry (both transports consume this)
*.ts — Individual tool implementations关键设计决策：
防病毒安全执行：PowerShell 脚本写入临时 .ps1 文件，并使用 -File 标志运行（而非会触发防病毒启发式检测的 -EncodedCommand）
统一注册表：单一工具定义，同时供 MCP 和 HTTP 传输使用
优雅降级：工具会检测功能不可用的情况（未安装 Docker、没有 WiFi 适配器等），并返回有用的提示信息而非错误
可操作的建议：每个工具不仅返回数据，还返回应对措施
受控的写入操作：危险操作需要显式指定 --allow-actions 标志
标志 | 描述 |
| 启动 HTTP 服务器而非 MCP stdio |
| HTTP 服务器端口（默认：7890） |
| 启用写入操作工具 |
| 打印版本和工具数量 |
| 打印所有工具及其描述 |
Windows 10/11
Node.js 20+
PowerShell 5.1+（随 Windows 附带）
MIT
This server cannot be deployed
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.