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.
Настройка клиентов
{
"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-селекторы.
World Monitor
Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.
mcp
Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.
Netdata
Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.