WindowsInstall MCP

Инструмент массового управления развёртыванием Windows на основе MCP (Model Context Protocol), поддерживает удалённую перезагрузку, переустановку через PXE, запланированные задачи и другие функции.

Обзор функций

Related MCP server: kvm-pilot

Требования к окружению

• Windows 10/11 или Windows Server

• Python 3.10+

• PowerShell 5.1+

• Права администратора — клиент ИИ должен запускаться от имени администратора

• WinRM включён (выполните winrm quickconfig или выполните следующую команду в PowerShell):

  Enable-PSRemoting -Force
  Set-Item WSMan:\localhost\Client\TrustedHosts * -Concatenate -Force

• iVentoy установлен и запущен (требуется для функции переустановки через PXE, по умолчанию прослушивает http://127.0.0.1:26000)

Предварительная настройка

1. Создание учётных данных машин

MCP автоматически создаст зашифрованный файл <имя_машины>.credential.xml через PowerShell Export-Clixml для аутентификации WinRM.

Примечание: XML, созданный одним пользователем Windows, может прочитать только этот же пользователь. MCP Server должен запускаться от имени того же пользователя, который создал учётные данные. Если этот MCP Server будет использовать другой человек, необходимо заново создать учётные данные для всех машин.

Добавление машин через диалог с MCP (рекомендуется) — MCP автоматически создаст файлы учётных данных и запишет их в machines.json:

添加 PC-03
IP 是 172.30.8.203
MAC 是 AA-BB-CC-DD-EE-03
用户名 public
密码 123456

Также можно вручную отредактировать machines.json, но сначала необходимо создать файлы учётных данных:

{
    "PC-01": {
        "ip": "172.30.8.200",
        "mac": "AA-BB-CC-DD-EE-01",
        "credential_file": "PC-01.credential.xml"
    }
}

2. Настройка MCP-клиента

Подробнее см. README в корневом каталоге.

Использование функций

Просмотр машин

查看所有电脑
查看 PC-01

Добавление машин

添加 PC-03
IP 是 172.30.8.203
MAC 是 AA-BB-CC-DD-EE-03
用户名 public
密码 123456

Также можно указать информацию о нескольких машинах за один раз.

Изменение машин

把 PC-01 的 IP 改成 172.30.8.201
把 PC-01 的 MAC 改成 AA-BB-CC-DD-EE-02
更新 PC-01 的登录凭据，用户名 public，密码 123456

Удаление машин

删除 PC-01
同时删除 PC-01 和 PC-02

Перезагрузка машин

重启 PC-01
同时重启 PC-01、PC-02、PC-03

Переустановка машин (необслуживаемая установка через PXE)

重装 PC-01
同时重装 PC-01 和 PC-02

Процесс: добавление MAC-адреса в iVentoy → автоматическое удаление через 60 секунд → перезагрузка через WinRM → загрузка через PXE → необслуживаемая установка.

Плановая перезагрузка

2026-08-19 02:00 重启 PC-01
2026-08-19 02:00 同时重启 PC-01 和 PC-02

Формат времени: YYYY-MM-DD HH:MM

Плановая переустановка

2026-08-19 03:00 重装 PC-01
2026-08-19 03:00 同时重装 PC-01、PC-02、PC-03

Просмотр/отмена запланированных задач

查看所有定时任务
取消任务 MCP_Reboot_20260819_0200_xxxxxxxx
取消 MCP_Reboot_xxx 和 MCP_Reinstall_xxx
取消全部定时任务

Просмотр TrustedHosts

查看 TrustedHosts

Структура проекта

.
├── server.py              # MCP Server 主程序
├── machines.json          # 机器配置（本地 JSON 文件存储）
├── scheduled_tasks.json   # 定时任务记录（本地 JSON 文件存储）
├── scheduled_jobs/        # 定时任务详情（本地 JSON 文件存储）
├── *.credential.xml       # 认证凭据（本地加密 XML 文件）
├── mcp.json               # MCP 客户端连接配置
├── requirements.txt       # Python 依赖
└── README.md

Примечания по безопасности

• Файлы учётных данных: *.credential.xml зашифрованы с помощью PowerShell Export-Clixml, доступны для чтения только создателю

• Чувствительные файлы добавлены в .gitignore: .credential.xml, machines.json, scheduled_tasks.json не будут отправлены в Git

• Пользователь запуска: MCP Server должен запускаться от имени того же пользователя Windows, который создал учётные данные. Учётные данные, созданные разными пользователями, несовместимы; при смене пользователя необходимо заново создать все учётные данные

• Сетевое воздействие: API iVentoy по умолчанию прослушивает 127.0.0.1:26000, доступ только с локальной машины. Для удалённого вызова убедитесь в правильности правил брандмауэра

License

MIT