MCP Linux Tools is an MCP (Model Context Protocol) server used to let AI assistants manage Linux servers, websites, and databases under strict security constraints.
Main capabilities include:
- Metadata and discovery: get server information, service whitelist, and list of allowed WordPress sites.
- File operations: read files, list directories, view log head/tail, search log keywords; create directories, modify permissions and ownership (limited to /var/www and /opt/).
- System services: check service status, reload or restart services in the whitelist (by default only restart; full restart can be forced).
- Python sandbox: execute Python code (no network, 8-second timeout).
- Cron management: list, add, delete, enable/disable cron jobs, and validate schedule expressions.
- WordPress operations: run WP-CLI, refresh cache, list plugins and users, view debug log paths.
- Database operations: execute read-only MySQL queries; dangerous queries are blocked.
- Network operations: ping hosts to test connectivity.
- Git operations: execute safe Git commands (push/force disabled).
- System commands: execute shell commands (use with caution).
Usage: The server requires Python 3.13 or higher, root privileges (for systemctl and crontab), and a Linux system that supports systemd. Installation steps include cloning the repository, creating a Python virtual environment, editing config.json to configure the server type/IP/name and directories, services, WordPress whitelist, etc., creating the sandbox directory, and installing and starting the systemd service. After that, add the HTTP transport address in the Cursor MCP configuration (default http://192.168.1.22:8765/mcp）。修改 The service must be restarted after config.json.
The architecture is a modular MCP design: server.py is the entry point, core/ contains error codes, Pydantic models, unified responses, security validation, and the subprocess runner, and tools/ divides tool modules by domain. All tools return a unified response contract {success, data, error, meta}.
Applicable scenarios: developers or operations personnel who need an AI assistant to assist with Linux server operations, managing WordPress sites, and databases, with the scope of operations limited by a whitelist.
Limitations: most tools are read-only; write operations are limited to specific whitelisted directories and services; stopping/starting/enabling services, sudo/root operations, networked Python, and modifying system crontab outside the MCP management scope are not allowed; all operations are restricted by the whitelist, and out-of-bounds actions return Denied; service names vary by distribution, so the actual whitelist must be queried; errors are returned with unified error codes (such as DENIED_PATH, DENIED_SERVICE, DENIED_SITE, INVALID_INPUT, COMMAND_BLOCKED, NOT_FOUND, TIMEOUT, etc.).
Specific fees, pricing, and platform compatibility details are not yet provided.
