MCP server de Linux
Commit 13 nov 2026Proporciona monitoreo y diagnóstico de sistemas Linux en tiempo real, incluyendo métricas de CPU, memoria, disco, red, procesos y Docker a través de herramientas MCP.
También conocido como Mohabdo21/linux-mcp, linux-mcp
- Stars
- 3
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.3.0
- Último commit
- 13 nov 2026
- Licencia
- MIT
¿Qué es Linux MCP?
Proporciona monitoreo y diagnóstico de sistemas Linux en tiempo real, incluyendo métricas de CPU, memoria, disco, red, procesos y Docker a través de herramientas MCP.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Linux
Linux MCP ofrece capacidades de monitoreo y diagnóstico en tiempo real para sistemas Linux a través del Model Context Protocol. Permite a desarrolladores y administradores de sistemas inspeccionar métricas de hardware, software y red utilizando un cliente de IA. El servidor opera mediante transporte stdio y puede integrarse en entornos como Claude Desktop, Claude Code, OpenCode o Codex. Requiere un entorno Linux y puede instalarse a través del MCP Registry, binarios precompilados o compilándolo desde el código fuente usando Go.
El servidor incluye 65 herramientas y 19 recursos que cubren una amplia gama de datos del sistema. Los usuarios pueden monitorear el uso de CPU, el consumo de memoria y swap, detalles de particiones de disco y estadísticas de interfaces de red. También proporciona visibilidad profunda de los procesos en ejecución, unidades de systemd y métricas de contenedores Docker. Las funciones de seguridad incluyen auditoría de inicios de sesión fallidos, estado del firewall y archivos SUID, mientras que las herramientas de hardware reportan información de GPU y dispositivos de bus PCI o USB.
Qué puedes hacer con él
- 1Analizar el rendimiento del sistemaSolicita un resumen completo del estado actual del sistema, incluyendo los promedios de carga y el uptime.
- 2Depurar entornos DockerVerifica el estado y el uso de recursos de los contenedores e imágenes en ejecución.
- 3Auditar la seguridad del sistemaIdentifica posibles riesgos de seguridad revisando los intentos de inicio de sesión fallidos y las configuraciones del firewall.
- 4Inspeccionar datos de bajo nivel del kernelRealiza diagnósticos profundos analizando interrupciones y estadísticas del sistema de archivos a través del directorio proc.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblemohabdo21/linux-mcp is public and reachablegithub.com/mohabdo21/linux-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-05github.com/mohabdo21/linux-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHublinux-mcp - Linux MCP Server
A Linux system monitoring server built on the Model Context Protocol (MCP). Provides real-time system information - CPU, memory, disk, network, processes, Docker, and more - via MCP tools over STDIO transport.
Features
- System - hostname, OS, kernel, architecture, uptime, load averages
- CPU - usage, model, frequency, core counts, temperature sensors
- Memory - RAM and swap usage with percentages
- Disk - per-partition usage, inodes, mount options, largest files, block devices
- Network - interface stats, active connections, listening ports, DNS, ping, IP geolocation & ASN lookup
- Processes - running processes sorted by CPU or memory, open file descriptors per process
- Docker - containers, images, networks, volumes, disk usage, system info, and container stats
- Services & automation - systemd units, service status, user timers, crontab, system cron jobs
- Security - active user sessions, failed login detection, SELinux/AppArmor status, firewall/SSH/SUID/world-writable audit with security score
- Packages - installed packages and available updates (pacman, dpkg, rpm/dnf, apk)
- Hardware - GPU info, PCI/USB bus devices, power/battery analytics
- Desktop session - Wayland/X11 protocol, DE identifiers, runtime config
- Storage health - RAID status, logrotate configuration, time synchronization, SMART disk health, per-device I/O metrics
- System health - comprehensive health assessment with memory, disk, load, and systemd checks
- /proc diagnostics - deep /proc inspection: interrupts, softirqs, vmstat, diskstats, filesystems, kernel version, slabinfo
- Man pages - system manual pages for any installed command
- Snapshot - comprehensive system overview in a single call
- MCP Resources - system data also accessible as readable resources
Prerequisites
- Go 1.27+ (to build from source)
- Linux (the server targets Linux; some tools use Linux-specific paths)
- Docker (optional - only needed for Docker tools)
Installation
Via MCP Registry
Discover the server on the MCP Registry and install via your MCP client (VS Code one-click install, or manual config).
Download pre-built binary
Download the latest binary from the GitHub Releases page:
curl -LO https://github.com/Mohabdo21/linux-mcp/releases/latest/download/linux-mcp
chmod +x linux-mcp
A fully static build (no libc dependency) is also available as linux-mcp_static.
Via go install
go install github.com/Mohabdo21/linux-mcp@latest
The binary is placed in $GOPATH/bin/ (typically ~/go/bin/).
Build from source
git clone https://github.com/Mohabdo21/linux-mcp.git
cd linux-mcp
make build
The binary is placed at bin/linux-mcp.
For a fully static binary (no libc dependency):
make build-static
Usage
The server communicates over STDIO transport, following the MCP standard. It is designed to be launched by an MCP client (e.g., Claude Desktop, Claude Code, Codex, OpenCode, or any MCP host).
Running directly
./bin/linux-mcp
This starts the server and listens for MCP requests on STDIN/STDOUT.
Integration
Add the following to your OpenCode configuration:
{
"mcp": {
"linux-mcp": {
"type": "local",
"command": ["/path/to/linux-mcp"],
"enabled": true
}
}
}
Add the server via the CLI:
claude mcp add linux-mcp -- /path/to/linux-mcp
To scope it to all your projects instead of just the current one:
claude mcp add linux-mcp --scope user -- /path/to/linux-mcp
Or create a .mcp.json file in your project root for team-shared configuration:
{
"mcpServers": {
"linux-mcp": {
"type": "stdio",
"command": "/path/to/linux-mcp"
}
}
}
Verify the connection inside a Claude Code session with /mcp.
Add the server via the CLI:
codex mcp add linux-mcp -- /path/to/linux-mcp
Or add it manually to ~/.codex/config.toml (or .codex/config.toml for project-scoped config):
[mcp_servers.linux-mcp]
command = "/path/to/linux-mcp"
Verify the connection with codex mcp list.
Tools and resources
65 tools and 19 resources covering system, CPU, memory, disk, network, processes, Docker, security, packages, hardware, and more.
Full tool and resource reference
Configuration
The server can be configured via a JSON file loaded from ~/.config/linux-mcp/config.json or the LINUX_MCP_CONFIG environment variable.
{
"log_level": "info",
"timeouts": {
"get_system_snapshot": "60s",
"ping_host": "5s"
},
"disabled": []
}
| Field | Description |
|---|---|
log_level |
One of debug, info, warn, error (default: info) |
timeouts |
Per-tool timeout overrides as Go duration strings |
disabled |
Tool names to disable, including their resource and aggregate collector paths |
Invalid configuration prevents startup. The server also handles SIGHUP to reload the configuration file at runtime without restarting; a failed reload retains the last valid configuration. Disabled collectors are skipped by aggregate tools and reported in their errors.
Docker diagnostic responses omit environment values and raw command arguments, including image-history commands. Other diagnostic content, such as logs and labels, can still contain sensitive data; grant access only to trusted clients.
MCP Registry
Published on the MCP Registry as io.github.Mohabdo21/linux-mcp.
License
Dependencies
- modelcontextprotocol/go-sdk - MCP SDK for Go
- shirou/gopsutil/v4 - System metrics (CPU, memory, disk, network, processes, sensors)
- docker/go-sdk - Docker Engine API client
- moby/moby/client - Docker client library
- ip-api.com - Free IP geolocation API (used by
get_ip_info)
Preguntas sobre Linux MCP
¿Qué información del sistema puedo monitorear?
Puedes monitorear el hostname, el SO, el kernel, la arquitectura, el uptime, los promedios de carga (load averages), el uso de CPU, la memoria, las particiones de disco, estadísticas de red y los procesos en ejecución.
¿Este servidor soporta el monitoreo de Docker?
Sí, proporciona herramientas para contenedores, imágenes, redes, volúmenes, uso de disco, información del sistema y estadísticas de contenedores.