Linux Info Mcp

by ranglust

166 downloads
Not rated
GitHub

About

62(and growing) read-only diagnostic tools that let Claude inspect your Linux fleet without touching it. Files, systemd, performance, networking, processes, disks, kernel, packages,

Details

Author
ranglust
Downloads
166
Categories
Other

- Read-only by construction: no code path mutates state.
- Injection-hardened: shell quoting, flag whitelists, host allowlist.
- Uses your existing SSH config and agent; no credentials shared.
- Bounded output, per-call timeouts, capped multi-host fan-out (25 max).
- Auditable: structured stdout/stderr/exit_code + optional JSONL logs.
- 62+ hardened diagnostic tools covering system aspects and Docker.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Linux Info Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Set up with Python via uv, configure with a single mcpServers entry in your MCP client, and tune behavior using environment variables. Works with Claude Desktop and Claude Code. Run any tool on one host or pass a list for parallel execution (capped at 25 hosts per call).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "linux info mcp": {
            "linux-info": {
                "command": "uv",
                "args": [
                    "run",
                    "--directory",
                    "/Users/ronenangluster/repos/linux-info-mcp",
                    "linux-info-mcp"
                ],
                "env": {
                    "LINUX_INFO_SSH_CMD": "ssh",
                    "LINUX_INFO_HOSTS": "",
                    "LINUX_INFO_TIMEOUT": "30",
                    "LINUX_INFO_MAX_BYTES": "1048576",
                    "LINUX_INFO_MAX_HOSTS": "10",
                    "LINUX_INFO_PARALLELISM": "4",
                    "LINUX_INFO_LOG_FILE": "",
                    "LINUX_INFO_LOG_LEVEL": "INFO"
                }
            }
        }
    }
}

McpServers

{
    "linux-info": {
        "command": "uv",
        "args": [
            "run",
            "--directory",
            "/Users/ronenangluster/repos/linux-info-mcp",
            "linux-info-mcp"
        ],
        "env": {
            "LINUX_INFO_SSH_CMD": "ssh",
            "LINUX_INFO_HOSTS": "",
            "LINUX_INFO_TIMEOUT": "30",
            "LINUX_INFO_MAX_BYTES": "1048576",
            "LINUX_INFO_MAX_HOSTS": "10",
            "LINUX_INFO_PARALLELISM": "4",
            "LINUX_INFO_LOG_FILE": "",
            "LINUX_INFO_LOG_LEVEL": "INFO"
        }
    }
}

62(and growing) read-only diagnostic tools that let Claude inspect your Linux fleet without touching it. Files, systemd, performance, networking, processes, disks, kernel, packages,
Docker — each a hardened wrapper around a command you already trust, run over your own SSH config.

Read-only by construction: there is no code path that restarts a service, edits a file, installs a package, or runs anything that mutates state. Every argument is
validated and shell-quoted, flag injection is killed by per-tool whitelists, and hosts can be pinned to an allowlist. Point it at production and sleep.

Run any tool on one host, or pass a list to fan out in parallel — bounded, with a hard 25-host ceiling so a curious model can't trigger an SSH storm.

Why

- Can't break anything — no mutate path exists. No restart, no edit, no install, no -exec.
- Injection-hardened — shlex.quote everywhere, flag whitelists, NUL/newline rejection, host allowlist.
- Your SSH, your rules — uses your ssh/agent or any wrapper (tsh ssh, jump hosts). Server never sees a credential.
- Bounded — byte-capped output, per-call timeouts, capped multi-host fan-out.
- Auditable — structured {stdout, stderr, exit_code, truncated} + optional JSONL logs with per-call IDs.

Setup

Python via uv.
One mcpServers entry, tuned by env vars. Works with Claude Desktop and Claude Code.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.