Каталог MCP
alimuratkuslu
alimuratkuslu/byok-observability-mcp

alimuratkuslu/byok-observability-mcp

Name: alimuratkuslu/byok-observability-mcp
Availability: InStock
Author: alimuratkuslu

MCP сервер для запросов к observability-стекам (Grafana, Prometheus, Kafka UI, Datadog). Данные хранятся локально — ключи не покидают машину. Разработчики и SRE анализируют метрики, алерты и логи прямо из Claude Code, Codex или любого MCP клиента без настройки инфраструктуры.

README

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

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

byok-observability-mcp

Query your observability stack from Claude Code, Codex, or any MCP client and no data leaves your machine.

Bring Your Own Keys — credentials stay in env vars on your machine. No clone, no build, runs via npx.

Partial setup — configure only the backends you use. Tools for unconfigured backends are never exposed.

Quick Start · Tools · Credentials · Configuration · Scheduled Reports · Examples · Security · Development

How it works

     🤖 Claude Code / Codex CLI      
                 │                   
                 ▼                   
     ⚡ byok-observability-mcp       
        (Local npx process)          
                 │                   
  🔒 env vars never leave your machine 
                 │                   
                 ▼                   
 ┌─────────────────────────────────┐ 
 │  📊 Grafana     🔥 Prometheus   │ 
 │  🛶 Kafka UI    🐶 Datadog      │ 
 └─────────────────────────────────┘

⚡ Quick Start

Option A — Interactive wizard (recommended)

Run once, answer a few questions, get a ready-made .mcp.json:

npx byok-observability-mcp --init

The wizard will:

Let you pick which backends to configure
Ask for credentials per service
Test connectivity with your real endpoints before writing anything
Write .mcp.json to your project root or ~/.claude/ — your choice

grafana_get_alert_rules

Перечисляет все настроенные правила оповещений Grafana из provisioning API. Возвращает UID правила, название, условие, метки, аннотации, папку и группу правил. Используйте это, чтобы увидеть, какие правила оповещений определены.

Параметры

Без параметров.

grafana_get_dashboard

Получите полные сведения о панели Grafana, включая все её панели, по её UID. Используйте grafana_list_dashboards, чтобы найти UID.

Параметры

uidstringобязательный
The UID of the dashboard.

grafana_health

Проверьте подключение к Grafana и получите версию и статус базы данных. Используйте это, чтобы убедиться, что интеграция Grafana работает.

Параметры

Без параметров.

grafana_list_alerts

Выводит активные (или отфильтрованные) алерты из Grafana Alertmanager. Фильтрует по состоянию и меткам. Возвращает имя алерта, состояние, критичность, метки, аннотации и время запуска. Используйте это, чтобы ответить на вопрос «есть ли сейчас срабатывающие алерты?»

Параметры

stateenum
Filter alerts by state. 'firing' = active, unsuppressed alerts. 'pending' = alerts in evaluation, not yet firing. 'resolved' = inactive alerts. Omit to get all alerts.
firingpendingresolved
labelsstring
Comma-separated label matchers to filter alerts, e.g. 'team=backend,env=prod'. Each matcher is passed as a separate Alertmanager filter param.

grafana_list_dashboards

Выводит список дашбордов в Grafana с опциональным поисковым запросом. Возвращает UID, название, папку и теги.

Параметры

querystring
Optional search string to filter dashboards by title.

grafana_list_datasources

Выведи список всех источников данных, настроенных в Grafana (имя, тип, UID). Используй это, чтобы найти UID, необходимый для grafana_query_metrics.

Параметры

Без параметров.

grafana_query_metrics

Выполняет PromQL-выражение через источник данных Grafana Prometheus и возвращает результаты. Сначала используйте grafana_list_datasources, чтобы найти UID источника данных.

Параметры

datasource_uidstringобязательный
The UID of the Prometheus datasource in Grafana.
exprstringобязательный
The PromQL expression to evaluate.
fromstring
Start of the time range, e.g. 'now-1h', 'now-30m'. Defaults to 'now-1h'.
tostring
End of the time range, e.g. 'now'. Defaults to 'now'.
instantboolean
If true, returns a single instant value. If false, returns a time series. Defaults to true.

kafka_broker_health

Получает состояние брокеров для кластера Kafka - идентификаторы брокеров, хосты, порты и использование диска.

Параметры

cluster_namestringобязательный
The Kafka cluster name.

kafka_consumer_group_lag

Получает consumer lag для конкретной consumer group: смещение по разделам, конечное смещение и отставание. Выделяет разделы с ненулевым отставанием.

Параметры

cluster_namestringобязательный
The Kafka cluster name.
group_idstringобязательный
The consumer group ID.

kafka_describe_topic

Получает подробную информацию о конкретном топике Kafka: распределение партиций, репликация и данные о сегментах.

Параметры

cluster_namestringобязательный
The Kafka cluster name.
topic_namestringобязательный
The topic name.

kafka_list_clusters

Перечисляет все кластеры Kafka, настроенные в Kafka UI. Возвращает имя, статус, количество брокеров, количество топиков и информацию о партициях.

Параметры

Без параметров.

kafka_list_consumer_groups

Выведи список потребительских групп в кластере Kafka с указанием их состояния и количества участников.

Параметры

cluster_namestringобязательный
The Kafka cluster name.
pagenumber
Page number for pagination. Defaults to 1.
per_pagenumber
Number of groups per page. Defaults to 50.

kafka_list_topics

Вывести список топиков в кластере Kafka с указанием количества партиций, фактора репликации и количества недореплицированных партиций.

Параметры

cluster_namestringобязательный
The Kafka cluster name. Use kafka_list_clusters to see available clusters.
pagenumber
Page number for pagination. Defaults to 1.
per_pagenumber
Number of topics per page. Defaults to 50.

obs_health_check

Запустите проверку работоспособности всех настроенных бэкендов наблюдаемости (Grafana, Prometheus, Kafka UI, Datadog) параллельно и верните сводную таблицу статусов. Используйте это, чтобы ответить на вопрос «все ли системы работают?»

Параметры

Без параметров.

obs_investigate_incident

Мета-инструмент, который выполняет параллельные запросы root cause analysis (RCA) ко всем включённым бэкендам. Автоматически проверяет Grafana на наличие сработавших оповещений, Prometheus — на офлайн-точки (up==0), а также кластеры Kafka на наличие офлайн-брокеров.

Параметры

Без параметров.

prometheus_health

Проверяет подключение к Prometheus. Возвращает статус healthy/unhealthy.

Параметры

Без параметров.

prometheus_list_metrics

Вывести список всех доступных имен метрик в Prometheus. Полезно для поиска, когда вы не знаете точное имя метрики.

Параметры

Без параметров.

prometheus_metric_metadata

Получить текст справки, тип и единицу измерения для конкретной метрики Prometheus. Опустите metric_name, чтобы вывести все метаданные.

Параметры

metric_namestring
The metric name to look up. Omit to retrieve metadata for all metrics.

prometheus_query

Выполняет мгновенный запрос PromQL и возвращает текущее значение(я). Лучше всего подходит для проверки текущего состояния метрики (например, загрузка ЦП прямо сейчас).

Параметры

querystringобязательный
The PromQL expression to evaluate.
timestring
Evaluation timestamp as RFC3339 or Unix timestamp. Defaults to current time.

prometheus_query_range

Выполните запрос диапазона PromQL и верните временной ряд. Используйте это, чтобы увидеть, как изменялась метрика со временем.

Параметры

querystringобязательный
The PromQL expression to evaluate.
startstring
Start time as RFC3339 or Unix timestamp. Defaults to 1 hour ago.
endstring
End time as RFC3339 or Unix timestamp. Defaults to now.
stepstring
Query resolution step, e.g. '60s', '5m', '1h'. Defaults to '60s'.

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

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

{
  "command": "npx",
  "args": [
    "-y",
    "byok-observability-mcp"
  ],
  "env": {
    "GRAFANA_URL": "https://grafana.mycompany.internal",
    "GRAFANA_TOKEN": "glsa_...",
    "PROMETHEUS_URL": "https://prometheus.mycompany.internal",
    "KAFKA_UI_URL": "https://kafka-ui.mycompany.internal",
    "DD_API_KEY": "your-datadog-api-key",
    "DD_APP_KEY": "your-datadog-app-key"
  }
}

Также alimuratkuslu/byok-observability-mcp можно установить в Cursor по ссылке автоматически.

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

Номер в рейтинге: #185
Звезд на Github: 4
Форков на Github: 0
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 16.07 в 21:23
Идентификатор: UKIX42KnAH2IFpVV
Категории: Базы данных, Визуализация данных, ИИ и машинное обучение, Инструменты для разработчиков, Мониторинг, Наблюдаемость, Облачные платформы

Другие проверенные MCP-сервера

pipeboard-co/meta-ads-mcp

Meta Ads MCP позволяет AI-ассистентам управлять рекламными кампаниями на Facebook и Instagram: запускать кампании, загружать креативы, менять бюджеты и анализировать эффективность через обычный диа...

s2-streamstore/s2-sdk-typescript

официальный

TypeScript SDK для S2 — бессерверного хранилища стримов. Позволяет добавлять и читать данные, использовать сессии для высокопроизводительной записи/чтения с гарантиями порядка. Полезен разработчикам, работающим с потоковыми данными.

dynatrace-oss/dynatrace-mcp

официальный

MCP сервер для интеграции AI-ассистентов с Dynatrace: подтягивает реальные данные observability, проблемы, логи и DQL-запросы прямо в ваш редактор. Поможет разработчикам и SRE быстрее дебажить и мониторить продакшн без переключения контекста.

BetterDB-inc/monitor

официальный

BetterDB Monitor - MCP сервер для мониторинга Valkey/Redis с веб-интерфейсом и автообновлением. Автоматически определяет версию и возможности базы, отслеживает здоровье, медленные запросы, метрики Prometheus и аномалии в реальном времени. Полезен администраторам и DevOps для контроля производител...

Perplexity MCP

официальный

Официальный MCP-сервер Perplexity: веб-поиск, ответы на вопросы, ресёрч и рассуждения через модели Sonar и Search API.

skill-seekers/Skill_Seekers

MCP-сервер Skill Seekers преобразует документацию, GitHub, PDF, видео и 18 типов источников в структурированные знания для AI-систем. Подходит для создания AI-навыков (Claude, Gemini, OpenAI), RAG-...