Для чего этот сервер?

Этот MCP-сервер даёт AI-ассистентам вроде Claude или Codex прямой доступ к данным OpenObserve. Помогает искать логи, смотреть схемы потоков, загружать дашборды и трассы — прямо из чата. Разработчикам не нужно переключаться между инструментами, чтобы разобраться в инциденте или проанализировать события. Всё работает через обычный REST API, без лишних танцев с настройкой.

Что он умеет?

Читает списки стримов и дашбордов в текущей организации, получает схему конкретного стрима, выполняет полноценные SQL-запросы к логам, выбирает записи вокруг конкретного лог-сообщения, получает уникальные значения полей за временной интервал, возвращает определение дашборда по id и последние трейсы из трейс-стрима.

Каталог MCP
alilxxey/openobserve-community-mcp

alilxxey/openobserve-community-mcp

от alilxxey

MCP сервер для OpenObserve Community Edition в режиме read-only через stdio и REST API. Выполняет поиск логов, просмотр схем потоков и дашбордов. Интегрируется с Claude и Codex для анализа данных OpenObserve без права записи.

Github PyPi Сайт сервера

README

8 инструментов

Версии

Установить сервер

OpenObserve MCP

stdio MCP server for OpenObserve Community Edition, using only the regular REST API.

This package is designed for local MCP clients such as Claude and Codex.

What it is:

stdio only
Community Edition only
read-only only
regular OpenObserve REST API only
no native /mcp endpoint

The server can boot without an active OpenObserve configuration so hosted MCP platforms can start it, but every tool call still requires a reachable external OpenObserve instance configured via OO_BASE_URL and credentials.

Quick Start

1. Create a config file

uvx --from openobserve-community-mcp openobserve-mcp init-config

This creates a sample config at:

~/.config/openobserve-mcp/config.env

Edit it:

vim ~/.config/openobserve-mcp/config.env

Example:

OO_BASE_URL=https://openobserve.example.com
# Optional if the credentials have access to exactly one organization.
# OO_ORG_ID=default
OO_AUTH_MODE=basic
OO_USERNAME=your_username
OO_PASSWORD=your_password
OO_TIMEOUT_SECONDS=20
OO_VERIFY_SSL=true

2. Add it to Claude

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

Часто задаваемые вопросы

Инструменты были проиндексированы: 15.10.2026

get_dashboard

Получает определение дашборда по идентификатору.

Параметры

dashboard_idstringобязательный
include_rawboolean

get_latest_traces

Получает последние данные трассировки из потока трассировки. start_time и end_time принимают метки времени Unix в секундах, миллисекундах, микросекундах или наносекундах и нормализуются до микросекунд.

Параметры

end_timeintegerобязательный
filter_querystring | null
include_rawboolean
offsetinteger
sizeinteger
start_timeintegerобязательный
stream_namestringобязательный
timeoutinteger | null

get_stream_schema

Получает информацию о схеме для конкретного потока. Сначала использует эту информацию для подтверждения реальных имен полей перед написанием SQL; многие потоки логов выдают message, а не log. Увеличивает fields_limit для просмотра большего количества полей из больших схем.

Параметры

fields_limitinteger
include_rawboolean
stream_namestringобязательный

list_dashboards

Выводит список дашбордов в текущей организации.

Параметры

folderstring | null
include_rawboolean
page_sizeinteger | null
titlestring | null

list_streams

Перечисляет потоки, доступные в текущей организации.

Параметры

include_rawboolean
keywordstring
limitinteger
offsetinteger
sortstring
stream_typestring

search_around

Получает записи вокруг конкретной записи в журнале. Параметр key принимает временные метки Unix в секундах, миллисекундах, микросекундах или наносекундах для удобства, но лучший ввод — это точный _timestamp, возвращённый search_logs; иначе OpenObserve может не вернуть близлежащие строки. output_format может быть 'records' или 'columns' для более токен-эффективной формы таблицы. record_profile может быть 'generic' или 'kubernetes_compact'.

Параметры

include_rawboolean
keyintegerобязательный
output_formatstring
record_profilestring
regionsstring | null
sizeinteger
stream_namestringобязательный
timeoutinteger | null

search_logs

Выполняет полный SQL-поиск по логам OpenObserve. Пример построчного запроса: SELECT _timestamp, message FROM "my_stream" ORDER BY _timestamp DESC LIMIT 20. Пример агрегатного запроса: SELECT level, count(*) AS cnt FROM "my_stream" GROUP BY level ORDER BY cnt DESC LIMIT 20. В сомнительных случаях используйте двойные кавычки вокруг имён потоков в SQL, а актуальные имена полей проверяйте через get_stream_schema, не предполагая, что столбец обязательно называется log. start_time и end_time принимают метки времени Unix в секундах, миллисекундах, микросекундах или наносекундах и нормализуются до микросекунд. Параметр limit задаёт размер страницы API; если ваша конфигурация OpenObserve/DataFusion всё ещё жалуется на ORDER BY без SQL LIMIT, добавьте явный LIMIT и в SQL. output_format может быть 'records' или 'columns'; 'columns' особенно удобен для широких запросов SELECT * и позволяет сэкономить примерно 35–40% токенов. record_profile может быть 'generic' или 'kubernetes_compact'; компактный профиль Kubernetes обрезает типичные шумные поля метаданных, такие как метки подов и IP-метаданные подов.

Параметры

end_timeintegerобязательный
include_rawboolean
limitinteger
offsetinteger
output_formatstring
record_profilestring
sqlstringобязательный
start_timeintegerобязательный
timeoutinteger | null
use_cacheboolean

search_values

Получает уникальные значения полей для потока за временной интервал. stream_name: необработанный сегмент пути имени потока, например my_stream; не заключайте его в кавычки, как SQL. fields: список полей, разделенных запятыми. filter_query использует синтаксис фильтра _values из OpenObserve, например kubernetes_pod_namespace=litellm. Простые равенства в стиле SQL, например kubernetes_pod_namespace='litellm', нормализуются автоматически. start_time и end_time принимают временные метки Unix в секундах, миллисекундах, микросекундах или наносекундах и нормализуются до микросекунд. В этом инструменте total означает количество возвращенных групп полей, а не общее количество совпадающих записей журнала.

Параметры

end_timeintegerобязательный
fieldsstringобязательный
filter_querystring | null
include_rawboolean
keywordstring | null
no_countboolean
offsetinteger
regionsstring | null
sizeinteger
start_timeintegerобязательный
stream_namestringобязательный
timeoutinteger | null

`0.2.6`основная	24.03.2026
`0.2.5`	23.03.2026
`0.2.4`	23.03.2026
`0.2.3`	23.03.2026
`0.2.2`	23.03.2026
`0.2.1`	23.03.2026
`0.2.0`	22.03.2026
`0.1.7`	22.03.2026
`0.1.6`	22.03.2026
`0.1.5`	22.03.2026
`0.1.4`	22.03.2026
`0.1.3`	21.03.2026
`0.1.1`	21.03.2026
`0.1.0`	21.03.2026

Выберите клиент, чтобы установить alilxxey/openobserve-community-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "alilxxey-openobserve-community-mcp-otpzif0kiq": {
      "command": "uvx",
      "args": [
        "--from",
        "openobserve-community-mcp",
        "openobserve-mcp"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "alilxxey-openobserve-community-mcp-otpzif0kiq": {
      "command": "uvx",
      "args": [
        "--from",
        "openobserve-community-mcp",
        "openobserve-mcp"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "alilxxey-openobserve-community-mcp-otpzif0kiq": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "openobserve-community-mcp",
        "openobserve-mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"alilxxey-openobserve-community-mcp-otpzif0kiq\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"--from\",\"openobserve-community-mcp\",\"openobserve-mcp\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "alilxxey-openobserve-community-mcp-otpzif0kiq": {
      "command": "uvx",
      "args": [
        "--from",
        "openobserve-community-mcp",
        "openobserve-mcp"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add alilxxey-openobserve-community-mcp-otpzif0kiq -- uvx --from openobserve-community-mcp openobserve-mcp

Либо через JSON-конфиг:

claude mcp add-json alilxxey-openobserve-community-mcp-otpzif0kiq "{\"command\":\"uvx\",\"args\":[\"--from\",\"openobserve-community-mcp\",\"openobserve-mcp\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add alilxxey-openobserve-community-mcp-otpzif0kiq -- uvx --from openobserve-community-mcp openobserve-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.alilxxey-openobserve-community-mcp-otpzif0kiq]
command = "uvx"
args = ["--from", "openobserve-community-mcp", "openobserve-mcp"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите alilxxey/openobserve-community-mcp, а в поле команды запуска — строку ниже:

uvx --from openobserve-community-mcp openobserve-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "alilxxey-openobserve-community-mcp-otpzif0kiq": {
      "command": "uvx",
      "args": [
        "--from",
        "openobserve-community-mcp",
        "openobserve-mcp"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "alilxxey-openobserve-community-mcp-otpzif0kiq": {
      "command": "uvx",
      "args": [
        "--from",
        "openobserve-community-mcp",
        "openobserve-mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например alilxxey-openobserve-community-mcp-otpzif0kiq.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: alilxxey-openobserve-community-mcp-otpzif0kiq
    command: uvx
    args:
      - "--from"
      - "openobserve-community-mcp"
      - "openobserve-mcp"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "alilxxey-openobserve-community-mcp-otpzif0kiq": {
      "command": "uvx",
      "args": [
        "--from",
        "openobserve-community-mcp",
        "openobserve-mcp"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "--from",
    "openobserve-community-mcp",
    "openobserve-mcp"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

Информация о сервере

Номер в рейтинге: #196
Звезд на Github: 16
Форков на Github: 2
Загрузок: 7 166
Язык реализации: Python
Лицензия: GPL-3.0
Официальный сервер: Нет
Дата обновления данных: 19.10 в 11:18
Идентификатор: gYnm6Qjvep2xdcF3
Категории: Мониторинг

alilxxey/openobserve-community-mcp

OpenObserve MCP

Quick Start

1. Create a config file

2. Add it to Claude

Часто задаваемые вопросы

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

Grafana MCP

ejcho623/agent-breadcrumbs

VictoriaMetrics-Community/mcp-victoriametrics

VictoriaMetrics-Community/mcp-victorialogs

TANTIOPE/datadog-mcp-server

mshegolev/jaeger-mcp