🪟 Windows Operations MCP — SOTA v14.1.0

Plano de control nativo de Windows y cirugía de datos para ecosistemas agentes

windows-operations-mcp es un servidor MCP especializado de grado industrial diseñado para proporcionar a los LLM un plano de control de alta fidelidad para operaciones nativas de Windows y manipulación compleja de datos. Evita la sobrecarga genérica del sistema de archivos para ofrecer una integración profunda con el Registro, cuentas de usuario, automatización de tareas y lógica de datos SOTA.

🚀 Capacidades clave (SOTA v14.0)

🛠️ Control nativo de Windows

• Gestión del Registro: Edición en modo seguro con copias de seguridad automáticas, consultas profundas de árbol y manipulación de valores.

• Operaciones de cuenta: Gestión de usuarios y grupos locales (listado, adición, restablecimiento de contraseñas).

• Centro de automatización: Orquestación de tareas programadas (schtasks) e introspección del sistema WMI/CIM.

• Permisos (ICACLS): Gestión granular de ACL de NTFS con control de herencia recursiva.

• Control de red: Orquestación nativa del firewall (netsh) y diagnósticos de adaptadores. [NUEVO]

• Cirugía de entorno: Gestión persistente de variables de entorno de usuario/sistema con difusión a todo el sistema. [NUEVO]

• Gestión de aplicaciones: Gestión de paquetes AppX/Store y eliminación automatizada de bloatware. [NUEVO]

🧬 Cirugía de datos especializada

• Portmanteau JSON: Parcheo profundo (fusión recursiva), extracción difusa de JSON de texto no estructurado y validación conforme a estándares.

• Lógica de archivos: Interfaz unificada para la expansión de ZIP, TAR y archivos Cabinet (.cab) nativos de Windows.

• Modo seguro: Preservación automática del estado (p. ej., exportaciones del Registro) antes de operaciones destructivas.

🛰️ Telemetría y muestreo de agentes

• FastMCP 3.2.0+: Soporte completo para telemetría ctx: Context.

• LLM-in-the-loop: ctx.sample() integrado para recuperación autónoma de fallos y sugerencias de reparación.

• Registro industrial: Registro asíncrono estructurado para entornos de alta concurrencia.

Related MCP server: Python MCP Custom Server

📦 Instalación

mcp install windows-operations-mcp

O manualmente a través de mcp_config.json:

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

🛠️ Referencia del registro de herramientas

📜 Barandillas éticas y seguridad

1. Modo seguro (Registro): Establecer safe_mode=True (predeterminado) exporta automáticamente las claves del Registro a backups/registry/ antes de cualquier escritura/eliminación.

2. Conciencia contextual: Los agentes reciben informes de progreso en tiempo real y registros de advertencia para operaciones de alto impacto.

3. Lógica reduccionista: Sin herramientas redundantes. Delegamos las tareas estándar del sistema de archivos a filesystem-mcp para mantener una capa de orquestación ligera y de alto rendimiento.

🧪 Desarrollo y pruebas

Requisitos previos

• Windows 10/11 Pro

• Python 3.10+

• fastmcp 3.2.0

Ejecución de pruebas

pytest

Autor: Sandra Schipal (Viena, AT)
Licencia: MIT

🛡️ Pila de calidad industrial

Este proyecto se adhiere a los estándares industriales SOTA 14.1 para la orquestación de agentes de alta fidelidad:

• Python (Núcleo): Ruff para linting y formateo. Tolerancia cero para declaraciones print en controladores principales (T201).

• Webapp (UI): Biome para linting de sub-milisegundos. Aplicación estricta de noConsoleLog.

• Cumplimiento del protocolo: Aislamiento endurecido de stdout/stderr para garantizar una comunicación JSON-RPC resistente a fallos.

• Automatización: Recetas de Justfile para todas las operaciones de flota (just lint, just fix, just dev).

• Seguridad: Auditorías automatizadas a través de bandit y safety.