Добавить сервер
alimuratkuslu/byok-observability-mcp
  1. Каталог MCP
  2. alimuratkuslu/byok-observability-mcp

alimuratkuslu/byok-observability-mcp

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

byok-observability-mcp

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

npm version License: MIT Awesome MCP Servers Node ≥18 alimuratkuslu/byok-observability-mcp MCP server

Grafana Prometheus Kafka UI Datadog

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

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обязательный

    UID дашборда.

grafana_health

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

Параметры

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

grafana_list_alerts

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

Параметры
  • labelsstring

    Матчеры меток для фильтрации алертов, разделённые запятыми, например: 'team=backend,env=prod'. Каждый матчер передаётся как отдельный параметр фильтра Alertmanager.

  • stateenum

    Фильтрует оповещения по состоянию. 'firing': активные, неподавленные оповещения. 'pending': оповещения на этапе оценки, ещё не сработавшие. 'resolved': неактивные оповещения. Если параметр опущен, возвращаются все оповещения.

grafana_list_dashboards

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

Параметры
  • querystring

    Необязательная строка поиска для фильтрации дашбордов по названию.

grafana_list_datasources

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

Параметры

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

grafana_query_metrics

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

Параметры
  • datasource_uidstringобязательный

    UID источника данных Prometheus в Grafana.

  • exprstringобязательный

    Выражение PromQL для вычисления.

  • fromstring

    Начало временного диапазона, например 'now-1h', 'now-30m'. По умолчанию равно 'now-1h'.

  • instantboolean

    Если true, возвращает одно мгновенное значение. Если false, возвращает временной ряд. По умолчанию true.

  • tostring

    Конец временного диапазона, например 'now'. По умолчанию используется 'now'.

kafka_broker_health

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

Параметры
  • cluster_namestringобязательный

    Имя кластера Kafka.

kafka_consumer_group_lag

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

Параметры
  • cluster_namestringобязательный

    Имя кластера Kafka.

  • group_idstringобязательный

    Идентификатор группы потребителей.

kafka_describe_topic

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

Параметры
  • cluster_namestringобязательный

    Имя кластера Kafka.

  • topic_namestringобязательный

    Название темы.

kafka_list_clusters

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

Параметры

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

kafka_list_consumer_groups

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

Параметры
  • cluster_namestringобязательный

    Имя кластера Kafka.

  • pagenumber

    Номер страницы для пагинации. По умолчанию: 1.

  • per_pagenumber

    Количество групп на странице. По умолчанию 50.

kafka_list_topics

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

Параметры
  • cluster_namestringобязательный

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

  • pagenumber

    Номер страницы для пагинации. По умолчанию: 1.

  • per_pagenumber

    Количество тем на странице. По умолчанию: 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

    Имя метрики для поиска. Опустите, чтобы получить метаданные для всех метрик.

prometheus_query

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

Параметры
  • querystringобязательный

    Выражение PromQL для вычисления.

  • timestring

    Временная метка оценки в формате RFC3339 или Unix-времени. По умолчанию используется текущее время.

prometheus_query_range

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

Параметры
  • endstring

    Время окончания в формате RFC3339 или Unix timestamp. По умолчанию - текущее время.

  • querystringобязательный

    Выражение PromQL для вычисления.

  • startstring

    Время начала в формате RFC3339 или Unix timestamp. По умолчанию 1 час назад.

  • stepstring

    Шаг разрешения запроса, например '60s', '5m', '1h'. По умолчанию: '60s'.

0.5.2основная
0.5.1
0.5.0
0.4.0
0.3.0
0.1.5
0.1.1
0.1.0

Выберите клиент, чтобы установить alimuratkuslu/byok-observability-mcp:

Любой клиент

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

{
  "mcpServers": {
    "alimuratkuslu-byok-observability-mcp-e3gd7cgcvu": {
      "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"
      }
    }
  }
}
CursorCursor

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

{
  "mcpServers": {
    "alimuratkuslu-byok-observability-mcp-e3gd7cgcvu": {
      "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"
      }
    }
  }
}
VS Code

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

{
  "servers": {
    "alimuratkuslu-byok-observability-mcp-e3gd7cgcvu": {
      "type": "stdio",
      "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"
      }
    }
  }
}

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

code --add-mcp "{\"name\":\"alimuratkuslu-byok-observability-mcp-e3gd7cgcvu\",\"type\":\"stdio\",\"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\"}}"
ClaudeClaude 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": {
    "alimuratkuslu-byok-observability-mcp-e3gd7cgcvu": {
      "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"
      }
    }
  }
}
Claude CodeClaude Code

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

claude mcp add alimuratkuslu-byok-observability-mcp-e3gd7cgcvu --env GRAFANA_URL=https://grafana.mycompany.internal --env GRAFANA_TOKEN=glsa_... --env PROMETHEUS_URL=https://prometheus.mycompany.internal --env KAFKA_UI_URL=https://kafka-ui.mycompany.internal --env DD_API_KEY=your-datadog-api-key --env DD_APP_KEY=your-datadog-app-key -- npx -y byok-observability-mcp

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

claude mcp add-json alimuratkuslu-byok-observability-mcp-e3gd7cgcvu "{\"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\"}}"
CodexCodex

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

codex mcp add alimuratkuslu-byok-observability-mcp-e3gd7cgcvu --env GRAFANA_URL=https://grafana.mycompany.internal --env GRAFANA_TOKEN=glsa_... --env PROMETHEUS_URL=https://prometheus.mycompany.internal --env KAFKA_UI_URL=https://kafka-ui.mycompany.internal --env DD_API_KEY=your-datadog-api-key --env DD_APP_KEY=your-datadog-app-key -- npx -y byok-observability-mcp

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

[mcp_servers.alimuratkuslu-byok-observability-mcp-e3gd7cgcvu]
command = "npx"
args = ["-y", "byok-observability-mcp"]

[mcp_servers.alimuratkuslu-byok-observability-mcp-e3gd7cgcvu.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"
PerplexityPerplexity

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

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите alimuratkuslu/byok-observability-mcp, а в поле команды запуска — строку ниже:
npx -y byok-observability-mcp

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

WindsurfWindsurf

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

{
  "mcpServers": {
    "alimuratkuslu-byok-observability-mcp-e3gd7cgcvu": {
      "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"
      }
    }
  }
}
ClineCline

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

{
  "mcpServers": {
    "alimuratkuslu-byok-observability-mcp-e3gd7cgcvu": {
      "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"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

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

mcpServers:
  - name: alimuratkuslu-byok-observability-mcp-e3gd7cgcvu
    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
Zed

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

{
  "context_servers": {
    "alimuratkuslu-byok-observability-mcp-e3gd7cgcvu": {
      "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"
      }
    }
  }
}

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

Grafana MCP

Grafana MCP

официальный

от grafana

MCP сервер для интеграции с Grafana: управляйте дашбордами, выполняйте запросы к Prometheus, Loki, CloudWatch и другим источникам через MCP. Упрощает мониторинг, анализ метрик и логов — полезен для инженеров и DevOps.

Go⭐ 3577
pab1it0/prometheus-mcp-server

pab1it0/prometheus-mcp-server

от pab1it0

MCP-сервер для прямого доступа к метрикам Prometheus. Позволяет AI-ассистентам выполнять PromQL-запросы, просматривать список метрик и получать их метаданные. Полезен инженерам, работающим с observ...

Python⭐ 519
TANTIOPE/datadog-mcp-server

TANTIOPE/datadog-mcp-server

от tantiope

MCP сервер для AI-ассистентов, открывающий полный доступ к Datadog: поиск логов, фильтрация APM-трейсов, запрос метрик, управление мониторами и дашбордами. Помогает SRE и разработчикам быстро разбирать инциденты, не переключаясь между инструментами.

TypeScript⭐ 6
last9/last9-mcp-server

last9/last9-mcp-server

официальный

от last9

Last9 MCP-сервер подключает AI-агентов (Claude, Cursor, Windsurf) к вашим производственным данным observability — логам, метрикам, трейсам, алертам. Без установки бинарников, через OAuth. Полезен S...

Go⭐ 63
yshngg/pmcp

yshngg/pmcp

от yshngg

MCP-сервер на Go для Prometheus: через MCP-клиенты можно общаться с метриками на естественном языке. Поддерживает мгновенные и range-запросы, метаданные, управление таргетами, правилами и TSDB — уд...

Go⭐ 4
tumf/grafana-loki-mcp

tumf/grafana-loki-mcp

от tumf

MCP сервер для запросов логов из Grafana Loki: позволяет выполнять LogQL-запросы, получать метки и значения, форматировать результаты. Полезен разработчикам и DevOps для анализа логов через MCP-инструменты.

Python⭐ 29
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин