Sky Windows Remote Executor

English | 简体中文

Sky Windows Remote Executor is a Windows-hosted FastAPI and MCP remote execution service for agentic workflows.

It runs on a Windows machine and exposes:

• a Web UI for task status, logs, file transfer, configuration, and audit events
• REST endpoints for script execution, PowerShell/CMD commands, files, process management, services, registry, scheduled tasks, network checks, and desktop helpers
• an MCP-compatible /mcp endpoint for tools such as run_command, fs_read, fs_write, patch_file, screenshot, clipboard, download_folder, and batch_download
• transfer tickets for large files so MCP stays a control plane rather than a bulk data channel

This project is intentionally different from SSH-wrapper based Windows remote executors. It is a resident HTTP/MCP service with a Web UI and task/audit logs.

Safety First

This service can execute commands and modify the Windows host. By default it binds to 127.0.0.1.

Expose it remotely only behind a trusted firewall, VPN, SSH tunnel, or reverse proxy. Read SECURITY.md before deployment.

Quick Start

python -m venv venv
.\venv\Scripts\python.exe -m pip install -r requirements.txt
.\venv\Scripts\python.exe -u windows_remote_executor.py

Open:

http://localhost:8765

MCP endpoint:

http://localhost:8765/mcp

Batch Helpers

• start-dev.bat - run in the foreground with repo-local .wre-data.
• start-silent.bat - launch with pythonw.
• start-service.bat - start the installed Windows service, or fall back to foreground mode.
• install-service.bat - install with NSSM.
• uninstall-service.bat - remove the NSSM service.

NSSM is not vendored. Install it separately and place nssm.exe on PATH, or copy it next to the scripts before running install-service.bat.

Configuration

Environment variables:

Variable	Default	Description
WRE_APP_NAME	Sky Windows Remote Executor	Display name
WRE_SERVICE_NAME	SkyWindowsRemoteExecutor	Windows service name
WRE_HOST	127.0.0.1	Uvicorn bind host
WRE_PORT	8765	HTTP/MCP port
WRE_DATA_DIR	%ProgramData%\SkyWindowsRemoteExecutor	Base runtime data directory
WRE_LOG_DIR	%WRE_DATA_DIR%\logs	Task and service logs
WRE_UPLOAD_DIR	%WRE_DATA_DIR%\uploads	Default uploads
WRE_TEMP_DIR	%WRE_DATA_DIR%\temp	Temporary zip/transfer files
WRE_LOG_RETENTION_DAYS	7	Task log retention

Example:

$env:WRE_HOST = "0.0.0.0"
$env:WRE_DATA_DIR = "D:\WindowsRemoteExecutor"
.\venv\Scripts\python.exe -u windows_remote_executor.py

MCP

See docs/mcp-guide.md and examples/codex-mcp-config.json.

Development

.\venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.\venv\Scripts\python.exe -m unittest discover -s tests -v

License

MIT.