SysFlow MCP (Lite Edition)

Free: Genesis Starter Kit (25 .cursorrules/CLAUDE.md rulesets + MCP configs). Try the live config builder. Full stack: all six servers in Genesis Enterprise Suite ($19).

SysFlow MCP is a lightweight, zero-overhead Model Context Protocol server that gives AI agents in Claude Desktop, Cursor, Windsurf, and Antigravity safe, structured access to Linux sysadmin inspection, log tailing, and service health without granting unrestricted root shells or risking interactive terminal freezes.

---

Run without cloning

uvx sysflow-mcp

Claude Desktop / Cursor config entry:

{
  "mcpServers": {
    "sysflow-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/johannschiffer/sysflow-mcp",
        "sysflow-mcp"
      ]
    }
  }
}

🖥️ Why SysFlow MCP?

Giving an AI assistant raw terminal execution often ends in frustration:

1. Interactive Terminal Freezes: Commands like journalctl, systemctl status, or git log default to interactive pagers (less), leaving the AI agent permanently hung waiting for user input.
2. Context Window Flooding: Tailing an unconstrained /var/log/nginx/access.log dumps thousands of lines into the LLM prompt, wasting tokens and causing memory errors.
3. Destructive Shell Commands: Without sandboxing, a hallucinated command can kill critical background daemons or delete workspace assets.

SysFlow exposes safe, bounded, non-blocking tools specifically tailored for autonomous developer agents.

---

⚡ Features (Lite Edition)

• 📊 Resource Healthcheck: Reports CPU core load averages (1m, 5m, 15m), RAM availability (MB and percentage), and disk partition metrics.
• 📜 Safe Log Tailer: Reads the last N lines (bounded and memory-safe) with optional regex filtering; automatically rejects binary files.
• ⚙️ Systemd User Service Inspector: Lists user-level services and timers (systemctl --user), highlighting failed units without requiring sudo.
• 🪶 Zero External Dependencies: Operates strictly on Python standard library and Linux /proc filesystem.

---

🚀 Quick Setup in 2 Minutes

1. Installation

git clone https://github.com/johannschiffer/sysflow-mcp.git
cd sysflow-mcp
pip install .

2. Configure Claude Desktop (claude_desktop_config.json)

On Linux: ~/.config/Claude/claude_desktop_config.json
On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sysflow": {
      "command": "python",
      "args": ["-m", "sysflow.server"],
      "cwd": "/path/to/sysflow-mcp"
    }
  }
}

3. Verify via CLI

python -m sysflow.cli resources

---

🛠️ MCP Tools Exposed to AI Agents

Tool	Parameters	Description
check_system_resources	(none)	Returns CPU load, memory usage, and partition disk metrics
tail_logs	filepath, lines, pattern	Safely tails recent log lines with optional regex filter
inspect_systemd_services	failed_only	Lists user-level services, states, and detects failed daemons
inspect_systemd_timers	(none)	Lists scheduled systemd user timers

---

💎 Need Enterprise Build Sandboxing? Upgrade to SysFlow Pro

Looking to automate shell task execution, manage Docker containers, or generate verified systemd units?

Feature	Lite (Open Source)	Enterprise Suite ($19)
CPU, RAM & Disk Monitoring	✅	✅
Safe Bounded Log Tailer	✅	✅
Systemd User Service Auditing	✅	✅
Sandboxed Task Runner with Timeouts (Anti-freeze)	❌	✅
Docker Container Health & Log Inspector	❌	✅
Verified Systemd Unit File Generator	❌	✅
Listening Socket & Port Conflict Auditor	❌	✅
Production Docker Container	❌	✅
Full Pytest Suite & Sysadmin Automation Guide	❌	✅

👉 Get the Genesis Enterprise Suite ($19)

---

📄 License

MIT License. See LICENSE for details.

Recommended Infrastructure

VPS hosting that work well with SysFlow MCP. Some links are referral links.

• Hetzner Cloud
• DigitalOcean

Genesis MCP Ecosystem

Module	What it does	Repo
CrawlEngine MCP	Anti-bot web scraping, clean Markdown, proxy rotation and TLS evasion	GitHub
BrowserBridge MCP	Deterministic headless browser automation with cryptographic action receipts	GitHub
PgSafe MCP	Zero-trust PostgreSQL/SQLite guard, live PII masking, zero-downtime migration checks	GitHub
OmniBridge MCP	Multi-channel notification and webhook bus with a persistent SQLite WAL queue	GitHub
SysFlow MCP (this repo)	Safe Linux administration plane: systemd, port audit, isolated execution	GitHub
FastMCP Forge	Production MCP server scaffolder: stdio, SSE and auth middleware	GitHub

Live config builder | Starter Kit, free | Enterprise Suite, $19