WindowsInstall MCP

Herramienta de gestión de implementación por lotes para Windows basada en MCP (Protocolo de Contexto de Modelo), compatible con reinicio remoto, reinstalación PXE, tareas programadas y más.

Descripción general de funciones

Related MCP server: kvm-pilot

Requisitos del entorno

• Windows 10/11 o Windows Server

• Python 3.10+

• PowerShell 5.1+

• Permisos de administrador: el cliente de IA debe ejecutarse con permisos de administrador

• WinRM habilitado (ejecute winrm quickconfig o en PowerShell):

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

• iVentoy instalado y en ejecución (la función de reinstalación PXE depende de él, escucha por defecto en http://127.0.0.1:26000)

Configuración previa

1. Generar credenciales de máquina

MCP generará automáticamente el archivo cifrado <nombre_de_máquina>.credential.xml mediante PowerShell Export-Clixml, utilizado para la autenticación WinRM.

Nota: el archivo XML solo puede ser leído por el mismo usuario de Windows que lo creó. El servidor MCP debe ejecutarse con la misma identidad de usuario que creó las credenciales. Si otra persona utiliza este servidor MCP, será necesario regenerar las credenciales para todas las máquinas.

Agregue máquinas mediante la conversación con MCP (recomendado); MCP generará automáticamente el archivo de credenciales y lo escribirá en machines.json:

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

También puede editar manualmente machines.json, pero primero debe generar el archivo de credenciales:

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

2. Configuración del cliente MCP

Consulte README en el directorio raíz.

Uso de funciones

Ver máquinas

查看所有电脑
查看 PC-01

Agregar máquinas

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

También puede proporcionar información de varias máquinas a la vez.

Modificar máquinas

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

Eliminar máquinas

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

Reiniciar máquinas

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

Reinstalar máquinas (PXE desatendido)

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

Flujo: agregar MAC a iVentoy → esperar 60 segundos para eliminación automática → reiniciar vía WinRM → arranque PXE → instalación desatendida.

Reinicio programado

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

Formato de hora: YYYY-MM-DD HH:MM

Reinstalación programada

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

Ver/Cancelar tareas programadas

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

Ver TrustedHosts

查看 TrustedHosts

Estructura del proyecto

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

Notas de seguridad

• Archivos de credenciales: *.credential.xml están cifrados con PowerShell Export-Clixml y solo pueden ser leídos por el usuario que los creó

• Archivos sensibles excluidos en .gitignore: .credential.xml, machines.json, scheduled_tasks.json no se enviarán al repositorio Git

• Usuario en ejecución: el servidor MCP debe ejecutarse con la misma identidad de usuario de Windows que creó las credenciales. Las credenciales creadas por diferentes usuarios no son compatibles entre sí; si cambia de usuario, deberá regenerar todas las credenciales

• Exposición de red: la API de iVentoy escucha por defecto en 127.0.0.1:26000, solo accesible localmente. Para acceso remoto, configure las reglas del firewall

Licencia

MIT