linux-mcp-server

Name: linux-mcp-server
Author: rhel-lightspeed

本地服务

github.com/rhel-lightspeed云与基础设施315今天更新

代码仓库

关于 linux-mcp-server

面向 RHEL 系统的只读 Linux MCP 服务，用于系统管理诊断与故障排查。支持通过 SSH 检查多台主机，并可配置日志访问范围。

主要功能

01只读系统诊断
02通过 SSH 执行远程命令
03同一会话管理多台主机
04检查服务、进程、日志、网络和存储
05配置可访问的日志文件

适用场景

01排查 RHEL 系统故障
02通过 SSH 检查多台远程主机
03在限制写入的情况下查看系统状态

MCP 相关

该 MCP 服务向 MCP 客户端提供 Linux 系统诊断工具，包括系统信息、服务、进程、日志、网络和存储检查。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "rhel-lightspeed-linux": {
      "command": "uvx",
      "args": [
        "linux-mcp-server"
      ],
      "env": {
        "LINUX_MCP_USER": "<LINUX_MCP_USER>",
        "LINUX_MCP_SSH_KEY_PATH": "<LINUX_MCP_SSH_KEY_PATH>",
        "LINUX_MCP_KEY_PASSPHRASE": "<LINUX_MCP_KEY_PASSPHRASE>",
        "LINUX_MCP_SEARCH_FOR_SSH_KEY": "<LINUX_MCP_SEARCH_FOR_SSH_KEY>",
        "LINUX_MCP_COMMAND_TIMEOUT": "<LINUX_MCP_COMMAND_TIMEOUT>",
        "LINUX_MCP_VERIFY_HOST_KEYS": "<LINUX_MCP_VERIFY_HOST_KEYS>",
        "LINUX_MCP_KNOWN_HOSTS_PATH": "<LINUX_MCP_KNOWN_HOSTS_PATH>",
        "LINUX_MCP_ALLOWED_LOG_PATHS": "<LINUX_MCP_ALLOWED_LOG_PATHS>",
        "LINUX_MCP_LOG_DIR": "<LINUX_MCP_LOG_DIR>",
        "LINUX_MCP_LOG_LEVEL": "<LINUX_MCP_LOG_LEVEL>",
        "LINUX_MCP_LOG_RETENTION_DAYS": "<LINUX_MCP_LOG_RETENTION_DAYS>"
      }
    }
  }
}

启动命令uvx linux-mcp-server

需要配置的环境变量

LINUX_MCP_USERDefault username for SSH connections

LINUX_MCP_SSH_KEY_PATH密钥Path to SSH private key

LINUX_MCP_KEY_PASSPHRASE密钥Passphrase for encrypted SSH key

LINUX_MCP_SEARCH_FOR_SSH_KEY密钥Auto-discover keys in `~/.ssh`

LINUX_MCP_COMMAND_TIMEOUTSSH command timeout in seconds (default: 30)

LINUX_MCP_VERIFY_HOST_KEYS密钥Verify remote host identity via known_hosts

LINUX_MCP_KNOWN_HOSTS_PATHCustom path to known_hosts file

LINUX_MCP_ALLOWED_LOG_PATHSComma-separated allowlist of log files

LINUX_MCP_LOG_DIRServer log directory

LINUX_MCP_LOG_LEVELLog verbosity (DEBUG, INFO, WARNING)

LINUX_MCP_LOG_RETENTION_DAYSDays to keep log files

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypilinux-mcp-server1.4.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
host	string	是	要运行的系统：'localhost' 表示 MCP 服务运行所在的系统；也可以指定要通过 SSH 连接的远程主机
unit	string	否	按 systemd 单元名称或模式筛选
since	string	否	筛选指定时间之后的条目（绝对时间或相对时间）
priority	string	否	按 syslog 优先级别（0-7）、名称或范围筛选
transport	any	否	按日志传输方式筛选（例如，'audit' 表示审计日志，'kernel' 表示内核消息，'syslog' 表示 syslog 消息）
last_lines	any	否	应用筛选条件后要检索的末尾日志行数（journalctl -n N）。默认值：100。与 first_lines 互斥。
first_lines	any	否	应用筛选条件后要检索的开头日志行数（journalctl -n +N）。与 last_lines 互斥。