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.

Related MCP server: mcp-smbmap

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:

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.