Skip to main content

linux-admin-mcp-server

Linux system administration via AI agents — MCP server for managing services, processes, disk, network and logs on Linux systems.

Features

  • 14 tools for complete Linux system management
  • System info: CPU, RAM, Uptime, Kernel, OS-Release
  • Disk & Memory: Usage statistics with warnings for high utilization
  • Health Check: Automated system health assessment (OK/WARNING)
  • Systemd Services: List, status, start/stop/restart, enable/disable, logs
  • Process Management: List processes sorted by CPU/memory, search by name
  • Network: Interfaces, open ports, active connections, DNS lookup
  • Safety: Only predefined commands, no arbitrary shell execution

Installation

pip install linux-admin-mcp-server

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "linux-admin": {
      "command": "linux-admin-mcp-server"
    }
  }
}

Note: Run Claude Desktop on your Linux machine, or use this server on a Linux system where you want AI-assisted administration.

Available Tools

Tool Description Sudo Required
system_info Hostname, kernel, CPU, RAM, uptime No
disk_usage Disk usage for all mounted filesystems No
memory_usage RAM and swap usage details No
health_check Full system health assessment No
services_list List systemd services (all/running/failed) No
service_status Detailed status of a specific service No
service_manage Start/stop/restart/enable/disable a service Yes
service_logs Last N log lines via journalctl No
processes_list Running processes sorted by CPU/memory No
process_find Find processes by name No
top_consumers Top 5 CPU and memory consumers No
network_interfaces Network interfaces and IP addresses No
open_ports Listening ports (LISTEN state) No
active_connections Established network connections No
dns_lookup Resolve hostname to IP address No

Example Prompts

  • "Show me the system health status"
  • "What services are currently failing?"
  • "Restart the nginx service"
  • "Show the last 100 lines of the postgres logs"
  • "Which processes are consuming the most memory?"
  • "What ports is this server listening on?"
  • "What's the disk usage on this machine?"

Requirements

  • Linux operating system (Ubuntu, Debian, CentOS, Fedora, etc.)
  • Python 3.10+
  • systemd (for service management tools)
  • ss or netstat (for network tools)
  • sudo access (only for service start/stop/enable/disable)

Compared to ssh-mcp-server

Feature linux-admin-mcp-server ssh-mcp-server
Use case Local Linux admin Remote via SSH
SSH required No Yes
systemd support Full (14 tools) Basic
Health check Yes No
Network tools 4 tools Limited

License

MIT License — AiAgentKarl 2026

Metadata

Release files for linux-admin-mcp-server 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for linux-admin-mcp-server 0.1.0
File Size Uploaded
linux_admin_mcp_server-0.1.0.tar.gz 8.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for linux-admin-mcp-server 0.1.0
File Interpreter ABI Platform
linux_admin_mcp_server-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 21.1 kB

Release files / linux_admin_mcp_server-0.1.0.tar.gz

Download URL linux_admin_mcp_server-0.1.0.tar.gz
Size 8.7 kB
Tags Source
SHA-256 checksum
How to use checksums
0d4b95ee29591f1c38d5fc57da4f03e7856314aacdc0f137ecdaab6404fb78d8
BLAKE2b-256 checksum
How to use checksums
c194785cdf69420c226e293037e5d1b8159a8cb9890b9d573cd74f52d89b8ed9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release files / linux_admin_mcp_server-0.1.0-py3-none-any.whl

Download URL linux_admin_mcp_server-0.1.0-py3-none-any.whl
Size 12.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fba0376d46b57b9296a5ce9a548f6b3528479e58b5790fe5c4d5eac1938cd64f
BLAKE2b-256 checksum
How to use checksums
0782ab5abad0d5bd54910f691b22fe6d88eb11306eb927594f6a88815af9c4c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page