Cross-platform FastMCP server for authenticated remote Linux/macOS host administration
MCPpedia last refreshed this data
io.github.Abktya/universal-host-manager-mcp is an MCP server that cross-platform FastMCP server for authenticated remote Linux/macOS host administration. Its tool list has not been published yet over http, requires no API key, and scores 82/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"io-github-abktya-universal-host-manager-mcp": {
"args": [
"universal-host-manager-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Cross-platform FastMCP server for authenticated remote Linux/macOS host administration
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
uvx 'universal-host-manager-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked universal-host-manager-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in data
Token-efficient database MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite
Manage Supabase projects — databases, auth, storage, and edge functions
A cross-platform desktop application for managing AI Agents and MCP Servers. 一款用于管理AI智能体与MCP服务器的跨平台桌面应用程序。
Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡
MCP Security Weekly
Get CVE alerts and security updates for io.github.Abktya/universal-host-manager-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A cross-platform Model Context Protocol server for administering a Linux or macOS host through MCP clients such as ChatGPT and Claude.
It uses FastMCP 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 before deploying it.
MCP_WORKSPACE_DIR| 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.
pip install universal-host-manager-mcp
Next: run uhm-setup to generate your .env — see Configure below.
Without polluting a project environment:
uvx --from universal-host-manager-mcp uhm-setup
This installs into a throwaway environment, runs the setup wizard, and writes .env in the current directory. From then on, run the server itself the same way: uvx universal-host-manager-mcp.
git clone https://github.com/Abktya/universal-host-manager-mcp.git
cd universal-host-manager-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Next: run uhm-setup to generate your .env — see Configure below.
The easiest way is the interactive setup wizard, installed alongside the server:
uhm-setup
Run it from the directory where you want to keep the configuration. The server must later be started from that same directory so it can find .env.
For a first test, choose 1 — Local-only test. Press Enter to accept the port 8765; the port prompt expects a number, not y or n. This mode:
workspace directory by default;127.0.0.1, so other computers cannot connect;The wizard also offers Cloudflare Tunnel, an ngrok static domain, and an existing HTTPS URL for remote use. Remote modes require Auth0 and will not write a misleading, unusable configuration if Auth0 is skipped. It validates domains and URLs, then writes .env with 600 permissions—backing up an existing file to .env.bak first.
If a virtual environment is active, install and run both commands through that environment:
python -m pip in
... [View full README on GitHub](https://github.com/abktya/universal-host-manager-mcp#readme)