WindowsInstall MCP

Ein auf MCP (Model Context Protocol) basierendes Windows-Massenbereitstellungs- und Verwaltungstool mit Unterstützung für Remote-Neustart, PXE-Neuinstallation, geplante Aufgaben und mehr.

Funktionsübersicht

Systemanforderungen

• Windows 10/11 oder Windows Server

• Python 3.10+

• PowerShell 5.1+

• Administratorrechte – Der KI-Client muss mit Administratorrechten ausgeführt werden

• WinRM ist aktiviert (führen Sie winrm quickconfig aus oder führen Sie den folgenden Befehl in PowerShell aus):

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

• iVentoy ist installiert und wird ausgeführt (erforderlich für die PXE-Neuinstallationsfunktion, lauscht standardmäßig auf http://127.0.0.1:26000)

Vorbereitende Konfiguration

1. Maschinenanmeldeinformationen generieren

MCP generiert automatisch eine verschlüsselte Datei <Maschinenname>.credential.xml über PowerShell Export-Clixml für die WinRM-Authentifizierung.

Hinweis: Nur XML-Dateien, die vom selben Windows-Benutzer erstellt wurden, können gelesen werden. Der MCP-Server muss mit demselben Benutzer ausgeführt werden, der die Anmeldeinformationen erstellt hat. Wenn eine andere Person diesen MCP-Server verwendet, müssen die Anmeldeinformationen für alle Maschinen neu generiert werden.

Maschinen über den MCP-Dialog hinzufügen (empfohlen) – MCP generiert automatisch die Anmeldeinformationsdatei und schreibt sie in machines.json:

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

Sie können machines.json auch manuell bearbeiten, müssen aber zuerst die Anmeldeinformationsdatei generieren:

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

2. MCP-Client-Konfiguration

Siehe README im Hauptverzeichnis.

Funktionsnutzung

Maschinen anzeigen

查看所有电脑
查看 PC-01

Maschine hinzufügen

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

Sie können auch Informationen für mehrere Maschinen auf einmal bereitstellen.

Maschine ändern

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

Maschine löschen

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

Maschine neu starten

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

Maschine neu installieren (PXE-unbeaufsichtigte Installation)

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

Ablauf: MAC zu iVentoy hinzufügen → 60 Sekunden warten, bis es automatisch entfernt wird → WinRM-Neustart → PXE-Start → unbeaufsichtigte Installation.

Geplanter Neustart

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

Zeitformat: YYYY-MM-DD HH:MM

Geplante Neuinstallation

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

Geplante Aufgaben anzeigen/abbrechen

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

TrustedHosts anzeigen

查看 TrustedHosts

Projektstruktur

.
├── 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

Sicherheitshinweise

• Anmeldeinformationsdateien: *.credential.xml werden mit PowerShell Export-Clixml verschlüsselt und sind nur für den Ersteller lesbar

• Sensible Dateien sind in .gitignore aufgenommen: .credential.xml, machines.json, scheduled_tasks.json werden nicht an Git übertragen

• Ausführender Benutzer: Der MCP-Server muss mit demselben Windows-Benutzer ausgeführt werden, der die Anmeldeinformationen erstellt hat. Anmeldeinformationen, die von verschiedenen Benutzern erstellt wurden, sind nicht kompatibel; wenn eine andere Person das System verwendet, müssen alle Anmeldeinformationen neu generiert werden

• Netzwerkexposition: Die iVentoy-API lauscht standardmäßig auf 127.0.0.1:26000 und ist nur für den lokalen Zugriff gedacht. Wenn Sie einen Remote-Zugriff benötigen, bestätigen Sie die Firewall-Regeln

Lizenz

MIT