linux-mcp-server — MCP-сервер для Claude Code
MCP-сервер читает данные Linux-систем, запускает диагностику и помогает искать причины сбоев. Подходит для RHEL-based систем и удалённой работы по SSH.
claude mcp add --env LINUX_MCP_USER=<LINUX_MCP_USER> --env LINUX_MCP_SSH_KEY_PATH=<LINUX_MCP_SSH_KEY_PATH> --env LINUX_MCP_KEY_PASSPHRASE=<LINUX_MCP_KEY_PASSPHRASE> --env LINUX_MCP_SEARCH_FOR_SSH_KEY=<LINUX_MCP_SEARCH_FOR_SSH_KEY> --env LINUX_MCP_COMMAND_TIMEOUT=<LINUX_MCP_COMMAND_TIMEOUT> --transport stdio linux-mcp-server -- uvx linux-mcp-serverЧто делает linux-mcp-server
linux-mcp-server предоставляет агенту доступ к диагностике Linux в режиме только чтения. Он показывает сведения о системе, службах, процессах, логах, сети и хранилище. Сервер ориентирован на RHEL-based системы и systemd.
Удалённые машины подключаются по SSH с аутентификацией по ключу; в одной сессии можно работать с несколькими хостами. Доступ к логам настраивается через переменные окружения, а запуск выполняется командой uvx linux-mcp-server. Режим только чтения ограничивает сервер диагностикой: он не меняет систему.
Какие задачи решает
- проверить состояние служб и процессов Linux
- найти ошибки в системных логах
- собрать сведения о сети и хранилище
- диагностировать удалённый хост по SSH
- сравнить состояние нескольких машин в одной сессии
Примеры запросов агенту
- Проверь состояние служб, процессов и системных логов на этом Linux-хосте.
- Подключись по SSH к удалённой машине и найди причины проблем с сетью.
- Собери диагностические сведения с нескольких хостов и сравни их состояние.
Как установить linux-mcp-server
Командой платформы
claude mcp add --env LINUX_MCP_USER=<LINUX_MCP_USER> --env LINUX_MCP_SSH_KEY_PATH=<LINUX_MCP_SSH_KEY_PATH> --env LINUX_MCP_KEY_PASSPHRASE=<LINUX_MCP_KEY_PASSPHRASE> --env LINUX_MCP_SEARCH_FOR_SSH_KEY=<LINUX_MCP_SEARCH_FOR_SSH_KEY> --env LINUX_MCP_COMMAND_TIMEOUT=<LINUX_MCP_COMMAND_TIMEOUT> --transport stdio linux-mcp-server -- uvx linux-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from linux-mcp-server <команда>
Командой платформы
codex mcp add linux-mcp-server --env LINUX_MCP_USER=<LINUX_MCP_USER> --env LINUX_MCP_SSH_KEY_PATH=<LINUX_MCP_SSH_KEY_PATH> --env LINUX_MCP_KEY_PASSPHRASE=<LINUX_MCP_KEY_PASSPHRASE> --env LINUX_MCP_SEARCH_FOR_SSH_KEY=<LINUX_MCP_SEARCH_FOR_SSH_KEY> --env LINUX_MCP_COMMAND_TIMEOUT=<LINUX_MCP_COMMAND_TIMEOUT> -- uvx linux-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from linux-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"linux-mcp-server": {
"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>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from linux-mcp-server <команда>
Файл настроек
{
"servers": {
"linux-mcp-server": {
"type": "stdio",
"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>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from linux-mcp-server <команда>
Командой платформы
gemini mcp add -e LINUX_MCP_USER=<LINUX_MCP_USER> -e LINUX_MCP_SSH_KEY_PATH=<LINUX_MCP_SSH_KEY_PATH> -e LINUX_MCP_KEY_PASSPHRASE=<LINUX_MCP_KEY_PASSPHRASE> -e LINUX_MCP_SEARCH_FOR_SSH_KEY=<LINUX_MCP_SEARCH_FOR_SSH_KEY> -e LINUX_MCP_COMMAND_TIMEOUT=<LINUX_MCP_COMMAND_TIMEOUT> linux-mcp-server uvx linux-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from linux-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о linux-mcp-server
Как установить linux-mcp-server в Claude Code?
Добавьте сервер командой claude mcp add linux-mcp-server -e LINUX_MCP_KEY_PASSPHRASE=<LINUX_MCP_KEY_PASSPHRASE> -- uvx linux-mcp-server.
Что делает linux-mcp-server?
Сервер даёт агенту инструменты для чтения сведений о Linux, проверки служб, процессов, логов, сети и хранилища. Он также подключается к удалённым хостам по SSH и работает с несколькими машинами в одной сессии.
Для каких Linux-систем предназначен сервер?
Сервер ориентирован на RHEL-based системы и systemd. Для удалённого доступа нужна аутентификация по SSH-ключу.
