# gerard-kanters/mcp-linux-tools [Health: Active]

**Category:** 🖥️ OS Automation  
**Repository:** https://github.com/gerard-kanters/mcp-linux-tools  
**GitHub Stars:** 2  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gerard-kanters-mcp-linux-tools

## Description
Administer a Linux server from an MCP client such as Cursor or VS Code: read files and tail logs, check/reload/restart systemd services, manage cron jobs inside a dedicated crontab section, run read-only MySQL queries, drive WP-CLI on WordPress sites, run safe Git commands, and execute sandboxed Python. Directories, services and WordPress sites are allowlisted in config.json, and every tool returns a uniform {success, data, error, meta} response. Runs as a systemd service over HTTP.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "mcp-linux-tools": {
    "url": "http://192.168.1.22:8765/mcp"
  }
}
```

## Documentation
MCP Linux Tools provides controlled server administration operations through configurable allowlists for directories, services, and WordPress sites. It supports file and log access, systemd and cron management, read-only MySQL queries, safe Git commands, WP-CLI operations, network checks, and sandboxed Python execution. Use it when an MCP client needs restricted operational access to a Linux system.

**Use cases:**
- Read files and tail logs from approved paths
- Check, reload, or restart allowlisted systemd services
- Manage cron jobs within a dedicated crontab section
- Inspect WordPress sites with WP-CLI
- Run read-only MySQL queries and safe Git commands

**Key features:**
- Allowlisted directories, services, and WordPress sites
- File listing, reading, and log head/tail operations
- Systemd status, reload, and restart controls
- Cron job listing and management
- Read-only MySQL queries with blocked dangerous queries
- Sandboxed Python execution with no network and an 8-second timeout

_Summarized from the repository README — see the link above for the full text._

