Serveur MCP Linux
Commit 13 nov. 2026Fournit une surveillance et un diagnostic du système Linux en temps réel, incluant les métriques CPU, mémoire, disque, réseau, processus et Docker via des outils MCP.
Aussi connu sous Mohabdo21/linux-mcp, linux-mcp
- Étoiles
- 3
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.3.0
- Dernier commit
- 13 nov. 2026
- Licence
- MIT
Qu'est-ce que Linux MCP ?
Fournit une surveillance et un diagnostic du système Linux en temps réel, incluant les métriques CPU, mémoire, disque, réseau, processus et Docker via des outils MCP.
Résumé généré à partir du README du projet
À propos du MCP server Linux
Linux MCP offre des capacités de surveillance et de diagnostic en temps réel pour les systèmes Linux via le Model Context Protocol. Il permet aux développeurs et aux administrateurs système d'inspecter les métriques matérielles, logicielles et réseau à l'aide d'un client IA. Le serveur fonctionne via le transport stdio et peut être intégré dans des environnements tels que Claude Desktop, Claude Code, OpenCode ou Codex. Il nécessite un environnement Linux et peut être installé via le MCP Registry, par des binaires précompilés ou en compilant depuis les sources avec Go.
Le serveur comprend 65 outils et 19 ressources couvrant un large éventail de données système. Les utilisateurs peuvent surveiller l'utilisation du CPU, la consommation de la mémoire et du swap, les détails des partitions de disque et les statistiques des interfaces réseau. Il offre également une visibilité approfondie sur les processus en cours, les unités systemd et les métriques des conteneurs Docker. Les fonctionnalités de sécurité incluent l'audit des échecs de connexion, le statut du pare-feu et les fichiers SUID, tandis que les outils matériels fournissent des informations sur le GPU et les périphériques des bus PCI ou USB.
Ce que vous pouvez faire avec
- 1Analyser les performances du systèmeDemandez une vue d'ensemble complète de l'état actuel du système, incluant les moyennes de charge et l'uptime.
- 2Déboguer des environnements DockerVérifiez le statut et l'utilisation des ressources des conteneurs et des images en cours d'exécution.
- 3Auditer la sécurité du systèmeIdentifiez les risques de sécurité potentiels en vérifiant les tentatives de connexion échouées et les configurations du pare-feu.
- 4Inspecter les données du noyau de bas niveauEffectuez des diagnostics approfondis en examinant les interruptions et les statistiques du système de fichiers via le répertoire proc.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblemohabdo21/linux-mcp is public and reachablegithub.com/mohabdo21/linux-mcp ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-05github.com/mohabdo21/linux-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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)
Questions sur Linux MCP
Quelles informations système puis-je surveiller ?
Vous pouvez surveiller le nom d'hôte, l'OS, le noyau, l'architecture, l'uptime, les moyennes de charge, l'utilisation du CPU, la mémoire, les partitions de disque, les statistiques réseau et les processus en cours d'exécution.
Ce serveur prend-il en charge la surveillance Docker ?
Oui, il fournit des outils pour les conteneurs, les images, les réseaux, les volumes, l'utilisation du disque, les informations système et les statistiques des conteneurs.