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을 통해 <머신 이름>.credential.xml 암호화 파일을 자동 생성하여 WinRM 인증에 사용합니다.

참고: 동일한 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

절차: 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 사용자로 실행해야 합니다. 다른 사용자가 만든 자격 증명은 서로 호환되지 않으므로, 다른 사람이 사용하려면 모든 자격 증명을 다시 생성해야 합니다.

• 네트워크 노출: iVentoy API는 기본적으로 127.0.0.1:26000을 수신하며, 로컬에서만 접근 가능합니다. 원격 호출이 필요한 경우 방화벽 규칙을 확인하세요.

License

MIT