What it does
The server runs on a Linux or macOS host and exposes five tools to MCP clients: run_command, which runs an arbitrary shell command with the workspace as its working directory and a timeout; read_file, write_file and list_dir, which work only inside the configured workspace directory; and system_metrics, which reports disk, memory and top-process information. Command timeouts, output truncation, file-size limits and a decoding fallback are configurable. Authentication uses FastMCP's Auth0 OAuth integration over a Streamable HTTP endpoint.
It suits cases where someone wants an MCP client to inspect or change files and run commands on a remote host, with Auth0 deciding who may connect. A local-only test mode listens on 127.0.0.1 without Auth0 and is intended only for a first trial. Example systemd and launchd service files are included.
Installation is through PyPI, uv or pipx, or from source. An interactive setup wizard writes a .env file with restricted permissions, offering a local test, Cloudflare Tunnel, an ngrok static domain or an existing HTTPS URL for remote use. Remote modes require an Auth0 API and application, with the public origin and callback URLs set as the publisher documents. The server must be started from the directory containing .env, and startup fails closed when authentication is not configured.
Limitations and requirements
Requires Python 3.10 or later and a Linux or macOS host. Remote use requires an Auth0 account and an HTTPS endpoint for MCP clients. The publisher warns that the project exposes arbitrary shell execution and that authentication does not make commands harmless; read SECURITY.md before deploying. The workspace boundary applies only to the file tools: run_command is not sandboxed and keeps all permissions of the service's OS user. Local test mode allows unauthenticated access. Masked Auth0 client secrets are rejected. The .env file must not be committed to version control.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.Abktya/universal-host-manager-mcp
Cross-platform FastMCP server for authenticated remote Linux/macOS host administration
v0.1.15As shown on registry.modelcontextprotocol.io when we last read it