🪟 Windows Operations MCP — SOTA v14.1.0

面向智能体生态系统的原生 Windows 控制平面与数据处理

windows-operations-mcp 是一个专业的工业级 MCP 服务器，旨在为大语言模型 (LLM) 提供用于 Windows 原生操作和复杂数据处理的高保真控制平面。它绕过了通用的文件系统开销，实现了与注册表、用户账户、任务自动化和 SOTA 数据逻辑的深度集成。

🚀 核心功能 (SOTA v14.0)

🛠️ Windows 原生控制

• 注册表管理：支持自动备份的安全模式编辑、深度树查询和值操作。

• 账户操作：本地用户和组管理（列出、添加、密码重置）。

• 自动化中心：计划任务 (schtasks) 编排和 WMI/CIM 系统内省。

• 权限 (ICACLS)：具有递归继承控制的细粒度 NTFS ACL 管理。

• 网络控制：原生防火墙编排 (netsh) 和适配器诊断。[新增]

• 环境手术：支持系统级广播的持久化用户/系统环境变量管理。[新增]

• 应用管理：AppX/商店包管理和自动化的臃肿软件移除。[新增]

🧬 专业数据处理

• JSON 组合工具：深度修补（递归合并）、从非结构化文本中进行模糊 JSON 提取以及符合标准的验证。

• 归档逻辑：用于 ZIP、TAR 和原生 Windows Cabinet (.cab) 解压的统一接口。

• 安全模式：在执行破坏性操作前自动进行状态保存（例如注册表导出）。

🛰️ 智能体遥测与采样

• FastMCP 3.2.0+：全面支持 ctx: Context 遥测。

• LLM-in-the-loop：集成 ctx.sample() 以实现自主故障恢复和修复建议。

• 工业级日志：针对高并发环境的结构化异步日志记录。

Related MCP server: Python MCP Custom Server

📦 安装

mcp install windows-operations-mcp

或者通过 mcp_config.json 手动配置：

{
  "mcpServers": {
    "windows-operations": {
      "command": "python",
      "args": ["-m", "windows_operations_mcp"],
      "env": {
        "PYTHONPATH": "C:/path/to/repo/src"
      }
    }
  }
}

🛠️ 工具注册表参考

📜 道德准则与安全

1. 安全模式 (注册表)：设置 safe_mode=True（默认）会在任何写入/删除操作前自动将注册表项导出到 backups/registry/。

2. 上下文感知：为智能体提供实时进度报告和针对高影响操作的警告日志。

3. 简化逻辑：无冗余工具。我们将标准文件系统任务委托给 filesystem-mcp，以保持精简、高性能的编排层。

🧪 开发与测试

先决条件

• Windows 10/11 Pro

• Python 3.10+

• fastmcp 3.2.0

运行测试

pytest

作者：Sandra Schipal (奥地利维也纳)
许可证：MIT

🛡️ 工业级技术栈

本项目遵循 SOTA 14.1 高保真智能体编排的工业标准：

• Python (核心)：使用 Ruff 进行代码检查和格式化。核心处理程序中严禁使用 print 语句 (T201)。

• Webapp (UI)：使用 Biome 进行毫秒级代码检查。严格执行 noConsoleLog。

• 协议合规性：强化 stdout/stderr 隔离，确保抗崩溃的 JSON-RPC 通信。

• 自动化：所有集群操作均使用 Justfile 配方 (just lint, just fix, just dev)。

• 安全性：通过 bandit 和 safety 进行自动化审计。