Cross-platform FastMCP server for authenticated remote Linux/macOS host administration
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"universal-host-manager-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Universal Host Manager MCP <!-- mcp-name: io.github.Abktya/universal-host-manager-mcp --> A cross-platform [Model Context Protocol](https://modelcontextprotocol.io/) server for administering a Linux or macOS host through MCP clients such as ChatGPT and Claude. It uses [FastMCP](https://gofastmcp.com/) Streamable HTTP transport, Auth0 OAuth, bounded file tools, output limits and command timeouts. > [!CAUTION] > This project exposes arbitrary shell execution. Authentication decides who may use it; it does not make commands harmless. Read [SECURITY.md](SECURITY.md) before deploying it. ## Features - Linux and macOS support - Streamable HTTP endpoint - Auth0 OAuth integration - File reads, writes and directory listings constrained to `MCP_WORKSPACE_DIR` - Configurable command timeouts and output truncation - File-size limits and decoding fallback - Fail-closed startup when authentication is not configured - Example systemd and launchd services ## Tools | Tool | Parameters | Purpose | | --- | --- | --- | | `run_command` | `command: str`, `timeout: int` | Runs an arbitrary shell command with the workspace as its working directory | | `read_file` | `path: str` | Reads a text file inside the workspace | | `write_file` | `path: str`, `content: str` | Writes UTF-8 text inside the workspace | | `list_dir` | `path: str = "."` | Lists a directory inside the workspace | | `system_metrics` | none | Reports disk, memory and top-process information | The workspace boundary applies to the file tools. It does **not** sandbox `run_command`; commands retain all permissions of the service's OS user. ## Requirements - Python 3.10+ - Linux or macOS - Auth0 account for remote use - HTTPS endpoint for remote MCP clients ## Install ```bash git clone https://github.com/Abktya/universal-host-manager-mcp.git cd universal-host-manager-mcp python3 -m venv .venv source .venv/bin/activate python -m pip install --upgrade pip pip install -r requirements.txt cp .env.example .env ``` Edi…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.