openobserve-community-mcp

openobserve-community-mcp — MCP-сервер сообщества (автор — alilxxey). Доступ только на чтение к OpenObserve Community Edition: поиск логов, трассировок, схем и дашбордов. Ставится через uvx или через Docker. Лицензия GPL-3.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
alilxxey
Лицензия
GPL-3.0
Транспорт
stdio
Авторизация
password
ОС
linux, macos, windows
Языки
python

Уровень риска: medium

Только чтение логов, дашбордов и трассировок OpenObserve Community Edition.

Настройка клиентов

codex
{
    "code": "codex mcp add openobserve-community -- uvx --from openobserve-community-mcp openobserve-mcp",
    "lang": "bash",
    "verified": "docs"
}

Неофициальный проект. Сервер сделан сообществом (автор — alilxxey), а не командой OpenObserve.

Что умеет

OpenObserve MCP — локальный (stdio) MCP-сервер для OpenObserve Community Edition, платформы для логов, метрик и трассировок. Он работает только через обычный REST API OpenObserve, без встроенной точки /mcp, и рассчитан на локальные клиенты вроде Claude и Codex. Главное ограничение — сервер только читает: ничего не меняет в вашем OpenObserve. Поддерживается только Community Edition.

Инструменты (описания — из исходного кода сервера):

  • list_streams — потоки в текущей организации (по умолчанию логи), с поиском по слову и постраничной выдачей.
  • get_stream_schema — схема потока. Её стоит вызывать первой, чтобы узнать настоящие имена полей перед SQL: во многих потоках логов поле называется message, а не log.
  • search_logs — полноценный SQL-поиск по логам, от выборки строк до агрегаций с группировкой. Время можно задавать в секундах, миллисекундах, микросекундах или наносекундах. Формат columns экономит примерно 35–40% токенов на широких запросах, а профиль kubernetes_compact убирает шумные метаданные подов.
  • search_around — записи вокруг конкретной строки лога; лучше всего передавать точный _timestamp из search_logs.
  • search_values — уникальные значения полей потока за период, с фильтром в синтаксисе OpenObserve.
  • list_dashboards и get_dashboard — список дашбордов организации и определение дашборда по идентификатору.
  • get_latest_traces — последние трассировки из потока трассировок.

Сервер может запуститься и без настроенного OpenObserve (это нужно размещённым MCP-платформам), но любой вызов инструмента требует доступного внешнего экземпляра OpenObserve и учётных данных.

Кому подойдёт

Инженерам эксплуатации и разработчикам, которые хранят логи и трассировки в OpenObserve Community Edition и хотят разбирать инциденты вопросами к агенту — без риска что-то изменить. Похожие серверы — в категории облака и DevOps.

Установка

Нужен uv. Создайте файл настроек командой uvx --from openobserve-community-mcp openobserve-mcp init-config — он появится в ~/.config/openobserve-mcp/config.env. Укажите в нём OO_BASE_URL, режим входа OO_AUTH_MODE (basic с OO_USERNAME и OO_PASSWORD или bearer с OO_TOKEN), при необходимости OO_ORG_ID, OO_TIMEOUT_SECONDS и OO_VERIFY_SSL. Настройки можно передать и через переменные окружения клиента. Есть Docker-образ ghcr.io/alilxxey/openobserve-community-mcp:latest и постоянная установка uv tool install openobserve-community-mcp.

Подключение к клиентам

Конфигурации из README. Подробнее — в инструкции как подключить MCP.

claude mcp add -s user openobserve-community -- uvx --from openobserve-community-mcp openobserve-mcp

Для OpenCode конфиг кладётся в ~/.config/opencode/opencode.json или в opencode.json проекта. Порядок чтения настроек: явный OO_CONFIG_FILE, затем ~/.config/openobserve-mcp/config.env, затем старый .env.local в текущей папке; переменные окружения перекрывают значения из файла.

Проверка

Попросите агента вызвать list_streams — он вернёт потоки логов вашей организации.

Примеры задач

Покажи последние 20 ошибок в потоке app_logs за последний час и сгруппируй их по уровню.
Найди строки вокруг этой ошибки и посмотри последние трассировки за то же время.

Риски

  • Доступ к логам. Агент видит всё, что видит учётная запись: в логах бывают персональные данные и секреты — используйте учётку с минимальными правами.
  • Учётные данные в config.env или в окружении клиента не храните в репозитории.
  • Отключение проверки SSL (OO_VERIFY_SSL=false) снижает защиту соединения.

Частые вопросы

Может ли сервер что-то изменить в OpenObserve?

Нет, он работает только на чтение.

Подойдёт ли Enterprise или облачная версия?

README заявляет поддержку только Community Edition.

Как сэкономить токены на больших выборках?

Используйте формат columns, а для Kubernetes — профиль kubernetes_compact.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Scrapling MCP Server

Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники