🪟 Windows Operations MCP — SOTA v14.1.0

Native Windows Control Plane & Data Surgery for Agentic Ecosystems

windows-operations-mcp is a specialized, industrial-grade MCP server designed to provide LLMs with a high-fidelity control plane for Windows-native operations and complex data manipulation. It bypasses generic filesystem overhead to offer deep integration with Registry, User Accounts, Task Automation, and SOTA Data Logic.

🚀 Key Capabilities (SOTA v14.0)

🛠️ Windows Native Control

• Registry Management: Safe-mode editing with auto-backups, deep tree queries, and value manipulation.

• Account Operations: Local user and group management (listing, adding, password resets).

• Automation Hub: Scheduled task (schtasks) orchestration and WMI/CIM system introspection.

• Permissions (ICACLS): Granular NTFS ACL management with recursive inheritance control.

• Networking Control: Native firewall orchestration (netsh) and adapter diagnostics. [NEW]

• Environment Surgery: Persistent User/System environment variable management with system-wide broadcasting. [NEW]

• App Management: AppX/Store package management and automated bloatware removal. [NEW]

🧬 Specialized Data Surgery

• JSON Portmanteau: Deep patching (recursive merging), fuzzy JSON extraction from unstructured text, and standards-compliant validation.

• Archive Logic: Unified interface for ZIP, TAR, and native Windows Cabinet (.cab) expansion.

• Safe Mode: Automatic state preservation (e.g., Registry exports) before destructive operations.

🛰️ Agentic Telemetry & Sampling

• FastMCP 3.2.0+: Full support for ctx: Context telemetry.

• LLM-in-the-loop: Integrated ctx.sample() for autonomous failure recovery and repair suggestions.

• Industrial Logging: Structured async logging for high-concurrency environments.

Related MCP server: Claude Desktop Commander MCP

📦 Installation

mcp install windows-operations-mcp

Or manually via mcp_config.json:

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

🛠️ Tool Registry Reference

📜 Ethical Guardrails & Safety

1. Safe Mode (Registry): Setting safe_mode=True (default) automatically exports Registry keys to backups/registry/ before any write/delete.

2. Contextual Awareness: Agents are provided with real-time progress reports and warning logs for high-impact operations.

3. Reductionist Logic: No redundant tools. We defer standard filesystem tasks to filesystem-mcp to maintain a lean, high-performance orchestration layer.

🧪 Development & Testing

Prerequisites

• Windows 10/11 Pro

• Python 3.10+

• fastmcp 3.2.0

Running Tests

pytest

Author: Sandra Schipal (Vienna, AT)
License: MIT

🛡️ Industrial Quality Stack

This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:

• Python (Core): Ruff for linting and formatting. Zero-tolerance for print statements in core handlers (T201).

• Webapp (UI): Biome for sub-millisecond linting. Strict noConsoleLog enforcement.

• Protocol Compliance: Hardened stdout/stderr isolation to ensure crash-resistant JSON-RPC communication.

• Automation: Justfile recipes for all fleet operations (just lint, just fix, just dev).

• Security: Automated audits via bandit and safety.