🪟 Windows Operations MCP — SOTA v14.1.0

Native Windows-Steuerungsebene & Datenchirurgie für agentische Ökosysteme

windows-operations-mcp ist ein spezialisierter MCP-Server in Industriequalität, der entwickelt wurde, um LLMs eine hochpräzise Steuerungsebene für Windows-native Vorgänge und komplexe Datenmanipulationen bereitzustellen. Er umgeht den allgemeinen Overhead des Dateisystems, um eine tiefe Integration in die Registrierung, Benutzerkonten, Aufgabenautomatisierung und SOTA-Datenlogik zu bieten.

🚀 Hauptfunktionen (SOTA v14.0)

🛠️ Native Windows-Steuerung

• Registrierungsverwaltung: Bearbeitung im abgesicherten Modus mit automatischen Backups, tiefen Baumabfragen und Wertemanipulation.

• Kontovorgänge: Verwaltung lokaler Benutzer und Gruppen (Auflisten, Hinzufügen, Zurücksetzen von Passwörtern).

• Automatisierungs-Hub: Orchestrierung geplanter Aufgaben (schtasks) und WMI/CIM-Systemintrospektion.

• Berechtigungen (ICACLS): Granulare NTFS-ACL-Verwaltung mit rekursiver Vererbungskontrolle.

• Netzwerksteuerung: Native Firewall-Orchestrierung (netsh) und Adapterdiagnose. [NEU]

• Umgebungschirurgie: Verwaltung persistenter Benutzer-/Systemumgebungsvariablen mit systemweitem Broadcasting. [NEU]

• App-Verwaltung: AppX/Store-Paketverwaltung und automatisierte Entfernung von Bloatware. [NEU]

🧬 Spezialisierte Datenchirurgie

• JSON-Portmanteau: Tiefgreifendes Patchen (rekursives Zusammenführen), Fuzzy-JSON-Extraktion aus unstrukturiertem Text und standardkonforme Validierung.

• Archivlogik: Einheitliche Schnittstelle für ZIP, TAR und native Windows Cabinet (.cab)-Entpackung.

• Abgesicherter Modus: Automatische Zustandssicherung (z. B. Registrierungsexporte) vor destruktiven Vorgängen.

🛰️ Agentische Telemetrie & Sampling

• FastMCP 3.2.0+: Volle Unterstützung für ctx: Context-Telemetrie.

• LLM-in-the-loop: Integriertes ctx.sample() für autonome Fehlerbehebung und Reparaturvorschläge.

• Industrielle Protokollierung: Strukturiertes asynchrones Logging für Umgebungen mit hoher Nebenläufigkeit.

Related MCP server: Python MCP Custom Server

📦 Installation

mcp install windows-operations-mcp

Oder manuell über mcp_config.json:

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

🛠️ Tool-Registrierungsreferenz

📜 Ethische Leitplanken & Sicherheit

1. Abgesicherter Modus (Registrierung): Das Setzen von safe_mode=True (Standard) exportiert automatisch Registrierungsschlüssel nach backups/registry/, bevor Schreib-/Löschvorgänge durchgeführt werden.

2. Kontextbewusstsein: Agenten erhalten Echtzeit-Fortschrittsberichte und Warnprotokolle für Vorgänge mit großen Auswirkungen.

3. Reduktionistische Logik: Keine redundanten Tools. Wir überlassen Standard-Dateisystemaufgaben filesystem-mcp, um eine schlanke, leistungsstarke Orchestrierungsschicht beizubehalten.

🧪 Entwicklung & Testen

Voraussetzungen

• Windows 10/11 Pro

• Python 3.10+

• fastmcp 3.2.0

Tests ausführen

pytest

Autor: Sandra Schipal (Wien, AT)
Lizenz: MIT

🛡️ Stack in Industriequalität

Dieses Projekt hält sich an die Industriestandards SOTA 14.1 für hochpräzise agentische Orchestrierung:

• Python (Kern): Ruff für Linting und Formatierung. Null-Toleranz für print-Anweisungen in Kern-Handlern (T201).

• Webapp (UI): Biome für Linting im Sub-Millisekundenbereich. Strenge Durchsetzung von noConsoleLog.

• Protokollkonformität: Gehärtete stdout/stderr-Isolierung, um eine absturzsichere JSON-RPC-Kommunikation zu gewährleisten.

• Automatisierung: Justfile-Rezepte für alle Flottenvorgänge (just lint, just fix, just dev).

• Sicherheit: Automatisierte Audits mittels bandit und safety.