WindowsInstall MCP

A Windows batch deployment management tool based on MCP (Model Context Protocol), supporting remote restart, PXE reinstallation, scheduled tasks, and more.

Feature Overview

Environment Requirements

• Windows 10/11 or Windows Server

• Python 3.10+

• PowerShell 5.1+

• Administrator privileges The AI client must run as administrator

• WinRM enabled (run winrm quickconfig or execute the following command in PowerShell):

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

• iVentoy installed and running (required for PXE reinstallation, listens on http://127.0.0.1:26000 by default)

Prerequisites

1. Generate Machine Credentials

MCP automatically generates an encrypted <machine-name>.credential.xml file via PowerShell Export-Clixml for WinRM authentication.

Note: Only XML created by the same Windows user can be read. The MCP Server must run as the same user who created the credentials. If a different person uses this MCP Server, you need to regenerate credentials for all machines.

Add machines via MCP conversation (recommended); MCP automatically generates credential files and writes them to machines.json:

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

You can also manually edit machines.json, but you need to generate the credential file first:

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

2. MCP Client Configuration

See root README for details.

Usage

View Machines

查看所有电脑
查看 PC-01

Add Machines

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

You can also provide information for multiple machines at once.

Modify Machines

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

Delete Machines

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

Restart Machines

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

Reinstall Machines (PXE Unattended Installation)

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

Process: Add MAC to iVentoy → wait 60 seconds for automatic removal → WinRM restart → PXE boot → unattended installation.

Scheduled Restart

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

Time format: YYYY-MM-DD HH:MM

Scheduled Reinstall

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

View/Cancel Scheduled Tasks

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

View TrustedHosts

查看 TrustedHosts

Project Structure

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

Security Notes

• Credential files: *.credential.xml are encrypted with PowerShell Export-Clixml and can only be read by the creator

• Sensitive files added to .gitignore: .credential.xml, machines.json, and scheduled_tasks.json will not be committed to Git

• Running user: The MCP Server must run as the same Windows user who created the credentials. Credentials created by different users are incompatible; if a different person uses it, all credentials must be regenerated

• Network exposure: The iVentoy API listens on 127.0.0.1:26000 by default, accessible only from the local machine. For remote calls, please confirm firewall rules

License

MIT