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)
ssornetstat(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)
| File | Size | Uploaded | |
|---|---|---|---|
| linux_admin_mcp_server-0.1.0.tar.gz | 8.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|