Workstation Remote FastMCP
by mpandudc
README.md
# Workstation Remote FastMCP
A lightweight Model Context Protocol (MCP) server built with **FastMCP** to control, inspect, and automate a Windows PC / workstation remotely via Wake-on-LAN and SSH/PowerShell.
## Features
- **`pc_wake`**: Power **ON** the PC via Wake-on-LAN (WOL) magic packet across LAN broadcast (ports 7, 9).
- **`pc_shutdown`**: Power **OFF** / complete shutdown of Windows PC (`shutdown.exe /s /f /t 0`).
- **`pc_reboot`**: Restart / reboot Windows PC (`shutdown.exe /r /f /t 0`).
- **`pc_sleep`**: Suspend workstation to S3 standby mode.
- **`pc_status`**: Check online state, Windows OS caption, uptime, CPU load percentage, and RAM usage.
- **`pc_lock`**: Instantly lock workstation session (`rundll32.exe user32.dll,LockWorkStation`).
- **`pc_list_heavy_processes`**: Identify processes consuming top RAM/CPU.
- **`pc_kill_process`**: Terminate hung or runaway processes by name or PID.
## Configuration
Configurable via environment variables or default constants:
- `WORKSTATION_USER`: Default `mpand`
- `WORKSTATION_TS_IP`: Default `100.116.2.118` (Tailscale IP)
- `WORKSTATION_LAN_IP`: Default `192.168.0.102` (LAN IP)
- `WORKSTATION_MAC`: Default `9C:6B:00:A2:31:54` (Ethernet MAC)
## License
MIT
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues