logmcp — MCP-сервер для Claude Code: доступ к логам без SSH
Даёт ИИ-ассистенту доступ к логам на удалённом Linux-сервере только на чтение. Пригодится, когда нужна помощь с диагностикой, а шелл выдавать не хочется.
Открыть на GitHubЧто делает logmcp
logmcp поднимает на сервере MCP-сервер, который отдаёт ассистенту логи по HTTPS. Ассистент видит только те файлы, что попали в белый список, и не может ничего изменить, удалить или выполнить. Каждое обращение пишется в syslog, содержимое логов туда не попадает.
Быстрый способ — logmcp quickstart: команда проверяет членство в группах adm и systemd-journal, генерирует bearer-токен и самоподписанный TLS-сертификат, запускает сервер и печатает готовую строку claude mcp add. Токен и сертификат при этом одноразовые, токен меняется при каждом старте. Для постоянной работы ставят через go install github.com/kascada/logmcp@latest или из .deb, затем sudo logmcp setup проводит по режиму TLS, токену и systemd-сервису. Конфиг лежит в /etc/logmcp/config.yaml, значения поддерживают подстановку переменных окружения вида ${VAR}; незаданные переменные разворачиваются в пустую строку.
Кроме файлов сервер умеет отдавать systemd journal как источник journald://, ведёт несколько токенов с отзывом, умеет делегировать проверку токена внешней программе и прятаться за Caddy. Расширения позволяют выставить наружу CLI-инструменты или воркеры Redis-RPC, а макросы описывают составные MCP-инструменты YAML-файлом. Если ассистент работает локально и у него есть SSH-ключ, можно обойтись SSH-туннелем вместо публичного HTTPS.
Какие задачи решает
- разобрать причину падения по логам на продакшн-сервере
- посмотреть journald, не открывая SSH-доступ ассистенту
- найти ошибку в логе по регулярному выражению с контекстом
- выдать подрядчику доступ к логам только на чтение
- проверить конфигурацию и окружение сервера перед разбором инцидента
Примеры запросов агенту
- Покажи последние 200 строк из
/var/log/nginx/error.logи объясни, что там происходит - Найди в
journald://записи про упавший сервис за последний час - Проверь окружение сервера и скажи, всё ли настроено верно
Как установить logmcp
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о logmcp
Как установить logmcp в Claude Code?
Поставьте сервер командой go install github.com/kascada/logmcp@latest, затем выполните sudo logmcp setup и пройдите шаги мастера. После этого logmcp client-config claude-code напечатает готовый фрагмент конфигурации MCP — вставьте его в конфиг клиента.
Что делает logmcp?
Открывает ассистенту логи на удалённом Linux-сервере по HTTPS в режиме только чтения. Ассистент может читать, искать и смотреть метаданные файлов, но не получает ни SSH, ни прав на запись.
Нужен ли root для запуска?
Для logmcp quickstart root не нужен: команда проверяет группы adm и systemd-journal и стартует от текущего пользователя. Если запускаете от root, передайте --user <name>, и сервер перезапустится под этим пользователем.
