🪟 Windows Operations MCP — SOTA v14.1.0

Нативная панель управления Windows и работа с данными для агентских экосистем

windows-operations-mcp — это специализированный MCP-сервер промышленного уровня, разработанный для предоставления LLM высокоточной панели управления для нативных операций в Windows и сложной обработки данных. Он обходит стандартные накладные расходы файловой системы, обеспечивая глубокую интеграцию с реестром, учетными записями пользователей, автоматизацией задач и логикой обработки данных SOTA.

🚀 Ключевые возможности (SOTA v14.0)

🛠️ Нативное управление Windows

• Управление реестром: Редактирование в безопасном режиме с автоматическим резервным копированием, глубокими запросами к дереву и манипуляцией значениями.

• Операции с учетными записями: Управление локальными пользователями и группами (просмотр, добавление, сброс паролей).

• Центр автоматизации: Оркестрация запланированных задач (schtasks) и интроспекция системы через WMI/CIM.

• Разрешения (ICACLS): Гранулярное управление списками контроля доступа (ACL) NTFS с контролем рекурсивного наследования.

• Управление сетью: Нативная оркестрация брандмауэра (netsh) и диагностика адаптеров. [НОВОЕ]

• Настройка окружения: Управление постоянными переменными окружения пользователя/системы с широковещательной рассылкой по всей системе. [НОВОЕ]

• Управление приложениями: Управление пакетами AppX/Store и автоматизированное удаление предустановленного ПО. [НОВОЕ]

🧬 Специализированная обработка данных

• JSON Portmanteau: Глубокое исправление (рекурсивное объединение), нечеткое извлечение 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 (Core): Ruff для линтинга и форматирования. Нулевая терпимость к операторам print в основных обработчиках (T201).

• Webapp (UI): Biome для линтинга с субмиллисекундной скоростью. Строгое соблюдение noConsoleLog.

• Соответствие протоколу: Усиленная изоляция stdout/stderr для обеспечения устойчивой к сбоям связи JSON-RPC.

• Автоматизация: Рецепты Justfile для всех операций парка (just lint, just fix, just dev).

• Безопасность: Автоматизированные аудиты через bandit и safety.