🪟 Windows Operations MCP — SOTA v14.1.0

📖 Installation Guide — quick start, manual setup, and troubleshooting

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.

Quick Start

git clone https://github.com/sandraschi/windows-operations-mcp
cd windows-operations-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

Related MCP server: Claude Desktop Commander MCP

🚀 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.

📦 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.