Linux MCP Server
MCP-сервер для диагностики Linux: ИИ-клиент читает службы, журналы и сеть локальных и удаленных систем без права записи
- 315 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Использует ваш SSH-ключ и подключается к удаленным серверам. Пароль от ключа лежит в переменной окружения
- Читает журналы и файлы систем, где могут быть секреты и персональные данные. Объем и пути ограничивают настройки
- Экспериментальный набор run_script позволяет модели выполнять скрипты на целевой системе
Установка
- Работает в
Ручная установка
uv tool install linux-mcp-serverРекомендуемый способ, uv сам подберет Python. Проверка: linux-mcp-server --version. Если команда не найдена, выполните uv tool update-shell.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Использует ваш SSH-ключ и подключается к удаленным серверам. Пароль от ключа лежит в переменной окружения
- Читает журналы и файлы систем, где могут быть секреты и персональные данные. Объем и пути ограничивают настройки
- Экспериментальный набор run_script позволяет модели выполнять скрипты на целевой системе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает ИИ-клиенту набор фиксированных инструментов только для чтения. Они охватывают службы и процессы, журналы, сеть и хранилище, а еще общие сведения о системе. Сервер рассчитан на системы на базе RHEL с systemd. К удаленным машинам он подключается по SSH с ключом, и в одной сессии можно обращаться к разным хостам. Доступ к журналам задается списком разрешенных путей в LINUX_MCP_ALLOWED_LOG_PATHS, а размер читаемых файлов ограничивает LINUX_MCP_MAX_FILE_READ_BYTES. Режим хоста определяет, где сервер вообще запускает инструменты: только локально, только на удаленных системах или везде. Экспериментальный набор run_script дает модели выполнять собственные скрипты на целевой системе. По умолчанию он выключен.
Для кого. Системным администраторам и SRE, которые хотят разбирать неполадки на Linux-серверах через ИИ-клиент.
Подходит, если
- Сервис на RHEL не стартует, и нужно прочитать состояние systemd и последние записи журнала
- Нужен обзор нескольких серверов за одну беседу: нагрузка, процессы, диски, сеть
- Хотите разобрать журнал приложения, но разрешить чтение только конкретных файлов
- Команда держит общий сервер MCP по HTTP с TLS, и доступ к нему нужно разделять между людьми
- Нужно собрать сведения о системе перед тем, как человек сам вносит исправления
Не подходит, если
- Нужно, чтобы агент сам менял конфигурацию и перезапускал службы: стандартный набор инструментов только читает
- Целевая система не Linux: локальное выполнение поддерживается только на Linux, на macOS и Windows работают лишь удаленные хосты
- Нет SSH-доступа к целевым машинам и нет доступа к ключам
Пример запроса к агенту
Подключись к хосту web-01 по SSH и покажи, какие службы в состоянии failed и что писал в журнал последний упавший сервисMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
LINUX_MCP_USER- Имя пользователя по умолчанию для SSH-подключений
LINUX_MCP_SSH_KEY_PATH- Путь к закрытому SSH-ключу
LINUX_MCP_KEY_PASSPHRASEсекрет- Пароль от зашифрованного SSH-ключа
LINUX_MCP_ALLOWED_LOG_PATHS- Список разрешенных для чтения файлов журналов через запятую
Ограничения
Нужны система управления, где работают сервер и ИИ-клиент, и целевая система: та же машина или удаленный хост по SSH. Локальное выполнение поддерживается только в Linux и отключено в контейнере. Для SSH задаются имя пользователя в LINUX_MCP_USER и ключ, пароль к ключу передается в LINUX_MCP_KEY_PASSPHRASE. Проверка ключей хоста по known_hosts включена по умолчанию. Для SSH-аутентификации через Kerberos нужен дополнительный пакет gssapi. Набор run_script экспериментальный: ему нужна отдельная модель-привратник у провайдера вроде OpenAI, Anthropic или Gemini, а песочница в нем пока примитивная.
Как отключить. Удалите запись linux-mcp-server из конфигурации MCP вашего клиента. Установленную через uv программу снимает команда uv tool uninstall linux-mcp-server, образ контейнера удаляется средствами podman или docker.
Частые вопросы
Как поставить Linux MCP Server для Claude Code?
Поставьте uv, выполните uv tool install linux-mcp-server и добавьте в файл ~/.claude.json запись mcpServers с путем к программе linux-mcp-server и переменной LINUX_MCP_USER. Вместо uv можно запустить готовый контейнер через podman или docker.
Может ли сервер менять что-то на машине?
Стандартный набор fixed только читает. Изменять систему можно лишь после включения экспериментального набора run_script, и тогда действуют проверка моделью-привратником, подтверждение человека и песочница.
Как подключиться к удаленным серверам?
По SSH с ключом. Задайте имя пользователя в LINUX_MCP_USER, путь к ключу в LINUX_MCP_SSH_KEY_PATH или включите автопоиск ключей в ~/.ssh. Параметр host в вызове инструмента выбирает машину.
Как ограничить чтение журналов?
Список разрешенных файлов задается в LINUX_MCP_ALLOWED_LOG_PATHS через запятую, а размер читаемого файла ограничивает LINUX_MCP_MAX_FILE_READ_BYTES.
Можно ли развернуть сервер для всей команды?
Да. Транспорт HTTP включается через LINUX_MCP_TRANSPORT, а TLS, аутентификация и авторизация описаны в руководстве по общему серверу, там же есть настройка через Keycloak.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамостоятельно размещаемый MCP-сервер для выполнения команд на удаленных серверах по SSH с токенами и ролями
SSH MCP Server (classfang) — команды на сервере по SSH
SSH MCP Server (classfang)
MCP-сервер для SSH: агент выполняет команды, читает и пишет файлы по SFTP, передает файлы и запускает долгие задачи, а пароли остаются у вас
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
SSH MCP
ssh-mcp
SSH-сервер с упором на безопасность: классификация команд, авторизация по политикам и разные способы входа. Выполняет команды на удаленных серверах
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
MCP-сервер для роутеров MikroTik: агент читает и меняет конфигурацию RouterOS по SSH по запросу из чата
Коротко о README
Подробные инструкции по установке и настройке собраны в документации проекта. Отдельное руководство описывает общий сервер для команды с TLS и входом через Keycloak.