WindowsInstall MCP

MCP (Model Context Protocol) ベースの Windows 一括デプロイ管理ツール。リモート再起動、PXE 再インストール、スケジュールタスクなどの機能をサポートします。

機能概要

環境要件

• Windows 10/11 または Windows Server

• Python 3.10+

• PowerShell 5.1+

• 管理者権限 AI クライアントは管理者として実行する必要があります

• 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 は PowerShell Export-Clixml を使用して、WinRM 認証用の <机器名>.credential.xml 暗号化ファイルを自動生成します。

注意：同じ Windows ユーザーが作成した XML のみ読み取ることができます。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

手順：iVentoy に MAC を追加 → 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 ユーザーとして実行する必要があります。異なるユーザーが作成した資格情報は互換性がないため、別のユーザーが使用する場合はすべての資格情報を再生成する必要があります

• ネットワーク公開：iVentoy API はデフォルトで 127.0.0.1:26000 をリッスンし、ローカルマシンからのみアクセス可能です。リモートから呼び出す場合は、ファイアウォールのルールを確認してください

License

MIT