# Linux MCP

> Linux MCP is an open-source MCP server for cloud and infrastructure. Read-only Linux system monitoring over MCP: CPU, memory, disk, network, Docker and more. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Repository:** https://github.com/mohabdo21/linux-mcp
- **MCP Registry name:** io.github.Mohabdo21/linux-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

A single Go binary that runs over stdio and exposes 65 tools and 19 resources, all aimed at inspecting the host it runs on. Beyond the basics of CPU, memory, disk and processes it reaches into systemd units, cron and timers, package lists and pending updates (pacman, dpkg, rpm/dnf, apk), SMART disk health, RAID status, GPU and PCI/USB devices, and deeper /proc views such as interrupts and slabinfo.

There is also a security group covering failed logins, SELinux or AppArmor status, and a firewall, SSH and SUID audit with a score, plus a one-call system snapshot and a health assessment. Docker tools are optional and only need Docker present.

A JSON config file can set log level, per-tool timeouts and a list of disabled tools, and SIGHUP reloads it without a restart. The README notes that Docker output omits environment values and raw command arguments, but logs and labels can still hold sensitive data, so it should only be given to trusted clients. IP geolocation uses the free ip-api.com service.

## Features

- **Broad host metrics:** CPU, memory, swap, disk, inodes, network and process data.
- **Docker inspection:** Containers, images, networks, volumes and container stats.
- **Security audit:** Failed logins, SELinux/AppArmor, firewall, SSH and SUID checks with a score.
- **Package and service views:** Installed packages, updates, systemd units and cron jobs.
- **Hardware and storage health:** GPU, PCI/USB, battery, SMART, RAID and I/O metrics.
- **Configurable tools:** Per-tool timeouts and a disable list, reloadable on SIGHUP.

## Good for

- Ask an assistant why a server is slow
- Review which services and cron jobs run on a machine
- Check disk health and RAID status
- Run a quick security audit of a host
- Inspect Docker disk usage

## Install

### Claude Code (Terminal)

```sh
claude mcp add linux-mcp -- npx -y https://github.com/Mohabdo21/linux-mcp/releases/download/v0.3.0/linux-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "linux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mohabdo21/linux-mcp/releases/download/v0.3.0/linux-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "linux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mohabdo21/linux-mcp/releases/download/v0.3.0/linux-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "linux-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mohabdo21/linux-mcp/releases/download/v0.3.0/linux-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "linux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mohabdo21/linux-mcp/releases/download/v0.3.0/linux-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "linux-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Mohabdo21/linux-mcp/releases/download/v0.3.0/linux-mcp"
      ]
    }
  }
}
```

## FAQ

### What do I need to run it?

A Linux host; Go 1.27 or newer is only needed to build from source, and Docker is optional for the Docker tools.

### How is it installed?

Via the MCP registry, a prebuilt release binary (a static build is also available), go install, or building with make.

### Can I turn tools off?

Yes, list tool names under disabled in the config file at ~/.config/linux-mcp/config.json or the path in LINUX_MCP_CONFIG.

### Which licence is it under?

MIT.

### Is Linux MCP free?

Yes. Linux MCP is open source, so you can use and self-host it for free.

### How do I add Linux MCP to Claude Code?

Run this command in your terminal: claude mcp add linux-mcp -- npx -y https://github.com/Mohabdo21/linux-mcp/releases/download/v0.3.0/linux-mcp

### What are the best alternatives to Linux MCP?

The closest alternatives to Linux MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/linux-mcp
