windows-host-mcp

Upload a file from this Linux machine to a Windows host over SFTP. Remote paths may use forward or back slashes.

Download a file from a Windows host to this Linux machine over SFTP — e.g. a build artifact or log.

List the contents of a directory on a Windows host. Large listings are capped inline and the full listing spilled to a temp file (.whmcp-tmp/).

Recursively copy a directory between this machine and a Windows host. direction 'up' pushes local→remote (e.g. source), 'down' pulls remote→local (e.g. artifacts).

List every configured Windows host with its capability labels (e.g. cuda, rocm), which one is active, and whether it is currently connected. Use this to pick a device, then switch with use_host.

Drop and re-establish the SSH connection to a host (defaults to the active host). Use this after changing the Windows account on the host side — e.g. adding it to a group like docker-users, or changing environment/PATH — since an existing SSH session won't pick those up until it reconnects.

Change which host subsequent commands target by default (the 'device switch'). Select by name, or by a capability label that matches exactly one host (e.g. label 'cuda'). Per-host session state (cwd/env) and jobs are preserved across switches.

Start a command that may run for a long time (e.g. a build or test suite) without waiting for it to finish. Runs on the active host unless host is given. Returns a jobId (unique across hosts). Poll output with get_job_output, feed stdin with send_job_input, and stop it with cancel_job. Set pty:true …

Fetch output from a running or finished job (any host — the jobId identifies it). Pass sinceOffset (the nextOffset from the previous call) to get only new output. Includes status and exit code once the job finishes.

Write input to a running job's stdin — e.g. answer a prompt or feed a REPL. A newline is appended by default.

Stop a running job. Sends a signal and closes the channel. Note: signal delivery is unreliable on Windows OpenSSH; for stubborn processes run a taskkill via run_command.

List jobs with their host, status, and exit codes. Defaults to all hosts; pass host to filter.

One-shot discovery of a Windows host so you don't have to guess: OS version, hostname/user, PATH, and which common tools (git, node, python, dotnet, cmake, docker, nvcc, ...) are installed and their versions. Also reports whether the current session cwd is valid. Run this before a build to avoid cal…

Given a list of executables, report which are on PATH and their versions. Use this before running a command that depends on a toolchain, instead of discovering it's missing when the command fails.

Verify the SSH connection to a host and return its hostname and current user. Defaults to the active host. Use this first to confirm setup.

Run a one-shot command on a Windows host and wait for it to finish. Returns stdout, stderr, and exit code. Defaults to the active host and its session shell/cwd/env; use start_job instead for long-running or interactive commands.

Return the default working directory, environment variables, and shell for a host (each host keeps its own). Defaults to the active host.

Update the default working directory, environment variables, and/or shell used by subsequent run_command / start_job calls on a host. env is merged into the existing defaults (pass null as a value to delete a var). A new cwd is verified to exist on the host before it is accepted, so a typo fails her…