Last9

{
  "mcp": {
    "servers": {
      "last9": {
        "type": "stdio",
        "command": "/opt/homebrew/bin/last9-mcp",
        "env": {
          "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
        }
      }
    }
  }
}

Для NPM: используйте "command": "npx" и добавьте "args": ["-y", "@last9/mcp-server@latest"].

После скачивания с GitHub Releases распакуйте и укажите полный путь:

{
  "mcpServers": {
    "last9": {
      "command": "C:\\Users\\<user>\\AppData\\Local\\Programs\\last9-mcp-server.exe",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

На Windows проще использовать NPM — не нужно управлять путями.

Запуск в HTTP-режиме

export LAST9_REFRESH_TOKEN="your_refresh_token"
export LAST9_HTTP=true
export LAST9_PORT=8080
./last9-mcp-server

Сервер запускается на http://localhost:8080/mcp.

Тестирование с помощью curl

Обработчик Streamable HTTP работает в stateless-режиме, поэтому любой запрос обслуживается независимо. Ручкопожатие initialize и заголовок Mcp-Session-Id необязательны — клиенты, которые их отправляют, все равно работают (заголовок принимается и игнорируется), а клиенты также могут перейти сразу к tools/list / tools/call. Каждый инструмент — это независимый запрос/ответ; сервер не отправляет уведомления сервер→клиент, поэтому GET /mcp (SSE-поток) возвращает 405.

# List tools — a session handshake is optional in stateless mode
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Call a tool
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Accept: application/json, text/event-stream" \
    -d '{
      "jsonrpc": "2.0",
      "id": 2,
      "method": "tools/call",
      "params": {
        "name": "get_service_logs",
        "arguments": {
          "service_name": "your-service-name",
          "lookback_minutes": 30,
          "limit": 10
        }
      }
    }'

Сборка из исходников

git clone https://github.com/last9/last9-mcp-server.git
cd last9-mcp-server
go build -o last9-mcp-server
LAST9_HTTP=true ./last9-mcp-server

LAST9_HTTP=true предназначен для локальной разработки. Для реального использования размещенная HTTP-конечная точка проще.

Ввод времени

• Абсолютное время (start_time_iso/end_time_iso, или time_iso) имеет приоритет над lookback_minutes.
• Для относительных окон: используйте lookback_minutes.
• Для абсолютных окон: используйте RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• Устаревший YYYY-MM-DD HH:MM:SS принимается только для совместимости.

get_exceptions

• limit (целое, необязательно): Максимум исключений. По умолчанию: 20.
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно): Абсолютный временной диапазон.
• service_name (строка, необязательно): Фильтр по сервису.
• span_name (строка, необязательно): Фильтр по имени спана.
• env (строка, необязательно): Фильтр по окружению.

get_service_summary

• start_time_iso / end_time_iso (строка, необязательно)
• env (строка, необязательно): PromQL-регулярное выражение. По умолчанию — .*. Для точного совпадения нужны якоря (например, ^prod$).
• sort_by (строка, необязательно): request_count (по умолчанию), throughput_rpm, http_4xx_count, http_5xx_count или grpc_error_count.
• limit (целое, необязательно): Максимум ранжированных строк. Если опущено или 0 — 10; значения выше 100 ограничиваются до 100.

get_service_environments

• start_time_iso / end_time_iso (строка, необязательно)

Все остальные инструменты APM требуют значение env. Используйте "", если этот инструмент возвращает пустой результат.

get_service_performance_details

• service_name (строка, обязательно)
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно)
• env (строка, необязательно): По умолчанию — prod.

get_service_operations_summary

• service_name (строка, обязательно)
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно)
• env (строка, необязательно): По умолчанию — prod.

get_service_dependency_graph

• service_name (строка, необязательно)
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно)
• env (строка, необязательно): По умолчанию — prod.

get_apm_service_deviations

• service_name (строка, необязательно): Опустите для охвата всего парка; укажите для одного сервиса и его корреляций операций.
• lookback_minutes (целое, необязательно): Текущее окно. По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно): Явное текущее окно.
• baseline_start_time_iso / baseline_end_time_iso (строка, необязательно): Явный базовый период. По умолчанию — непосредственно предшествующее окно той же длительности.
• datasource (строка, необязательно): Ограничить сравнение одним источником данных.
• env (строка, необязательно): По умолчанию — prod.
• max_services / max_operations (целое, необязательно): По умолчанию 10, максимум 10 каждый.

get_databases

• env (строка, необязательно): Фильтр по окружению. Принимает регулярное выражение. По умолчанию: все.
• lookback_minutes (целое, необязательно): По умолчанию: 60. Окно не может превышать 7 дней.
• start_time_iso / end_time_iso (строка, необязательно)

get_database_slow_queries

• db_system (строка, необязательно): например, postgresql, mysql, mongodb, redis.
• host (строка, необязательно): Хост базы данных (net_peer_name).
• service_name (строка, необязательно): Имя вызывающего сервиса.
• env (строка, необязательно)
• min_duration_ms (число с плавающей точкой, необязательно): Минимальная длительность запроса в мс.
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно)
• limit (целое, необязательно): По умолчанию: 20.

get_database_queries

• db_system (строка, необязательно)
• host (строка, необязательно)
• service_name (строка, необязательно)
• env (строка, необязательно)
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно)
• limit (целое, необязательно): По умолчанию: 20.

get_database_server_metrics

• db_system (строка, обязательно): например, postgresql, mysql, mongodb, redis, aerospike.
• host (строка, необязательно)
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• start_time_iso / end_time_iso (строка, необязательно)

prometheus_range_query

• query (строка, обязательно): PromQL-запрос.
• start_time_iso / end_time_iso (строка, необязательно): По умолчанию — последние 60 минут.
• lookback_minutes (число с плавающей точкой, необязательно): По умолчанию: 60.

prometheus_instant_query

• query (строка, обязательно)
• time_iso (строка, необязательно): По умолчанию — сейчас.
• lookback_minutes (число с плавающей точкой, необязательно)

prometheus_label_values

• match_query (строка, необязательно): PromQL-фильтр.
• label (строка, обязательно): Имя метки.
• start_time_iso / end_time_iso (строка, необязательно)

prometheus_labels

• match_query (строка, необязательно): PromQL-фильтр.
• start_time_iso / end_time_iso (строка, необязательно)

get_logs

• logjson_query (массив, обязательно): JSON-запрос конвейера.
• lookback_minutes (целое, необязательно): По умолчанию: 5.
• start_time_iso / end_time_iso (строка, необязательно)
• limit (целое, необязательно): Серверное значение по умолчанию: 5000.
• index (строка, необязательно): physical_index:<name> или rehydration_index:<block_name>.

Для инвентаризации сервисов на основе логов сначала запросите physical_index_service_count:

sum by (name, service_name, env) (physical_index_service_count{destination="logs"})

Используйте service_name как ServiceName, env как окружение, когда оно присутствует, и name как имя физического индекса. Если name="default", опустите index; для нестандартного физического индекса, выбранного пользователем, передайте index: "physical_index:<name>". Если бэкенд отклоняет явную фильтрацию по физическому индексу, повторите попытку без index и сообщите, что явная фильтрация по физическому индексу недоступна для этого бэкенда.

get_service_logs

• service_name (строка, обязательно)
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• limit (целое, необязательно): По умолчанию: 20.
• env (строка, необязательно)
• severity_filters (массив, необязательно): например, ["error", "warn"]. Логика ИЛИ.
• body_filters (массив, необязательно): например, ["timeout", "failed"]. Логика ИЛИ.
• start_time_iso / end_time_iso (строка, необязательно)
• index (строка, необязательно)

Несколько типов фильтров объединяются через И. Каждый массив использует ИЛИ внутри. Сначала используйте get_logs для широких агрегированных подсчетов; используйте get_service_logs только после сужения до сервиса/окружения/индекса и небольшого набора образцов.

get_log_attributes

• lookback_minutes (целое, необязательно): По умолчанию: 15.
• start_time_iso / end_time_iso (строка, необязательно)
• region (строка, необязательно)
• index (строка, необязательно)

get_log_attributes_for_pipeline

• pipeline (массив, обязательно): Предыдущие стадии фильтрации для ограничения обнаружения, например, [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (целое, необязательно): По умолчанию: 15.
• start_time_iso / end_time_iso (строка, необязательно)
• region (строка, необязательно)
• index (строка, необязательно)

get_drop_rules

Без параметров. Перечисляет правила отбрасывания через GET /otel_settings/drop?region=....

add_drop_rule

• name (строка, обязательно)
• filters (массив, обязательно): Каждый фильтр: key, value, operator (equals/not_equals), conjunction (and).
• Ключи фильтров должны использовать attributes["key_name"] или resource.attributes["key_name"] (требуется API Last9).
• Создает правило через POST /otel_settings/drop?region=...&cluster_id=....

get_traces

Используйте для широких поисков и агрегаций. Для точного поиска по ID трассировки используйте get_service_traces.

• tracejson_query (массив, обязательно)
• start_time_iso / end_time_iso (строка, необязательно)
• lookback_minutes (целое, необязательно): По умолчанию: 60.
• limit (целое, необязательно): По умолчанию: 5000.

get_service_traces

Требуется ровно одно из trace_id или service_name.

• trace_id (string, необязательный): Период просмотра по умолчанию: 72 часа.
• service_name (string, необязательный): Период просмотра по умолчанию: 60 мин.
• lookback_minutes (integer, необязательный)
• start_time_iso / end_time_iso (string, необязательный)
• limit (integer, необязательный): По умолчанию: 10.
• env (string, необязательный)

get_trace_attributes

• lookback_minutes (integer, необязательный): По умолчанию: 15.
• start_time_iso / end_time_iso (string, необязательный)
• region (string, необязательный)

get_trace_attributes_for_pipeline

• pipeline (array, обязательный): Предыдущие этапы фильтрации для ограничения области обнаружения, например [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, необязательный): По умолчанию: 15.
• start_time_iso / end_time_iso (string, необязательный)
• region (string, необязательный)

get_trace_attribute_values

• tag_name (string, обязательный): Имя атрибута из get_trace_attributes (например, resource_department или attributes['http.method']).
• pipeline (array, необязательный): Предыдущие этапы фильтрации для ограничения области значений; опустите для глобальных значений.
• lookback_minutes (integer, необязательный): По умолчанию: 15.
• start_time_iso / end_time_iso (string, необязательный): Исторические границы RFC3339; имеют приоритет над lookback_minutes.
• region (string, необязательный)

get_trace_attribute_deviations

• comparison_mode (string, обязательный): latency, errors или time.
• service_name (string, обязательный)
• environment (string, обязательный): Точное значение deployment.environment.
• operation (string, необязательный)
• filters (array, необязательный): Условия фильтрации JSON трассировки.
• candidate_attributes (array, необязательный): Максимум 8; опустите для ограниченного обнаружения.
• latency_threshold_ms (number, необязательный): Требуется для режима latency; отклоняется для других режимов.
• start_time_iso / end_time_iso (string, необязательный)
• lookback_minutes (integer, необязательный): По умолчанию: 15. Максимум: 15.
• baseline_start_time_iso / baseline_end_time_iso (string, необязательный): Требуется для режима time; неперекрывающиеся и равные по длительности целевому окну.
• minimum_cohort_size (integer, необязательный): По умолчанию: 100. Минимум: 20.
• minimum_value_support (integer, необязательный): По умолчанию: 20. Минимум: 10.
• limit (integer, необязательный): По умолчанию: 10. Максимум: 10.

Требует включения сопутствующей серверной возможности.

get_trace_waterfall

• trace_id (string, обязательный)
• environment (string, необязательный)
• start_time_iso / end_time_iso (string, необязательный)
• lookback_minutes (integer, необязательный): По умолчанию: 4320 (72 часа).
• selected_span_id (string, необязательный): Возвращает атрибуты, события и ссылки только для этого спана.
• max_spans (integer, необязательный): По умолчанию: 500. Максимум: 1000.

Возвращает конверт investigation-evidence/v1; водопад находится в data.

get_change_events

• start_time_iso / end_time_iso (string, необязательный)
• lookback_minutes (integer, необязательный): По умолчанию: 60.
• service_name (string, необязательный)
• env (string, необязательный)
• event_name (string, необязательный): Сначала вызовите без этого параметра, чтобы получить available_event_names.

get_alert_groups

Настроенный инвентарь групп оповещений Compass для аудита changeboard / покрытия меток. Включает группы без правил и группы, которые не срабатывают. Не возвращает PromQL.

• alert_group_name / alert_group_type / data_source_name (string, необязательный): Поиск подстроки без учёта регистра.
• team / tier (string, необязательный): Точное совпадение без учёта регистра по настроенным метаданным.
• label_key + label_value (string, необязательный): Должны быть заданы вместе. Точное совпадение без учёта регистра по одной паре metadata.labels — и ключ, и значение.

Возвращает компактный JSON {"count":N,"groups":[...]} с id, name, type, entity_class, team, tier, metadata.labels и количеством правил. Пустые team / labels означают, что значение не задано.

get_alert_config

• search_term (string, необязательный): Полнотекстовый поиск по имени, группе, источнику данных, тегам.
• rule_name (string, необязательный)
• severity (string, необязательный)
• rule_type (string, необязательный): static или anomaly.
• alert_group_name / alert_group_type / data_source_name (string, необязательный)
• tags (array, необязательный): Все должны совпадать (логика И).

get_alerts

• time_iso (string, необязательный): Время оценки в формате RFC3339.
• window (integer, необязательный): Период просмотра в секундах. По умолчанию: 900. Диапазон: 60–86400.
• lookback_minutes (integer, необязательный): Диапазон: 1–1440.

get_alert_rule_state

• start_time (integer, обязательный): Начало диапазона в Unix-эпохе (включительно).
• end_time (integer, обязательный): Конец диапазона в Unix-эпохе (включительно).
• step (integer, обязательный): Разрешение в секундах между выборками. Количество выборок ((end_time - start_time) / step + 1) ограничено 100.
• alert_group_id (string, необязательный): Фильтр по ID группы оповещений.
• rule_name (string, необязательный): Regex-фильтр по имени правила.
• alert_group_name (string, необязательный): Regex-фильтр по имени группы оповещений.
• label_filters (string, необязательный): Фильтры меток key=value, разделённые запятыми.
• state (string, необязательный): Фильтр по состоянию (например, firing).

Возвращает JSON-карту rule_id -> [{timestamp, is_firing}]. Временная метка, в которой правило отсутствует в ответе вышестоящей системы, сообщается как is_firing=0 — это означает «не наблюдалось как срабатывающее», а не подтверждённое нормальное состояние.

get_notification_channels

Без параметров. Возвращает все настроенные каналы уведомлений (Slack, PagerDuty, email, вебхуки и т. д.).

did_you_mean

• query (string, обязательный): Имя для поиска — частичное, с опечаткой или сокращённое.
• type (string, необязательный): Ограничение по типу сущности: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Возвращает до 3 ближайших совпадений с оценками схожести. Используйте это перед любым вызовом инструмента, если имя сущности неопределённо. Если предыдущий вызов вернул пустые результаты, попробуйте это перед повторной попыткой.

get_service_profile

• service_name (string, обязательный): Сервис, для которого нужно получить телеметрический профиль.
• datasource (string, необязательный): Имя источника данных. Опустите для источника по умолчанию.

Возвращает краткую сводку для расследования, за которой следует полный профиль в виде необработанного JSON: наличие сигналов (logs/traces/metrics как present, absent или unknown), язык и среда выполнения, среды развёртывания, signal_shape логов (log_format, severity_set, level_field) и рекомендуемое исправление приёма данных, если применимо. Получено из вышестоящей системы и кэшируется с TTL около 15 минут.

Вызывайте это перед любым расследованием, ограниченным сервисом, чтобы выбор инструментов соответствовал фактической телеметрии сервиса — пропускайте инструменты трассировки, когда traces равен absent, а когда severity_set равен none или partial, извлекайте серьёзность из level_field в теле лога, а не используйте severity_filters. metrics всегда unknown, а dependencies не заполнен в v1. Когда logs и traces оба равны absent, подтвердите имя с помощью did_you_mean, прежде чем делать вывод, что сервис не мониторится.

list_dashboards

Без параметров. Возвращает все пользовательские дашборды в организации в виде JSON-массива с id, name и метаданными.

get_dashboard

• id (string, обязательный): UUID дашборда.
• region (string, необязательный): Регион для заполнения запросов панелей. По умолчанию — регион настроенного источника данных.

validate_dashboard

Только чтение. Никогда не создаёт и не обновляет дашборды. Принимает ровно один из dashboard_id или dashboard_definition.

• dashboard_id (string, необязательный): UUID сохранённого дашборда для проверки.
• dashboard_definition (object, необязательный): Встроенное тело несохранённого дашборда (истинный прогон без сохранения).
• start_time_iso / end_time_iso (string, необязательный): Окно проверки (RFC3339). Должно быть ≤ 24 ч.
• region (string, необязательный): Регион для выполнения запросов панелей.

Возвращает dashboard_validation/v1: классификация lint + выполнение по каждой панели (data / no_data / invalid / error). Пустые результаты на первый день классифицируются как valid_no_data без диагностических проб.

create_dashboard

Только новый. После того как этот вызов вернёт dashboard.id, уточняйте с помощью update_dashboard — не создавайте снова, чтобы добавить, обрезать или исправить панели.

• dashboard (object, обязательный): Определение дашборда с name и panels[]. Каждая панель требует name, version, layout (x, y, w, h), visualization.type и queries[].
• metadata (object, необязательный): Метаданные дашборда — поля _category и _type (например, {"_category":"custom","_type":"metrics"}).

update_dashboard

Предпочтительно использовать после create. Полная замена по id (то же тело, что и при create).

• id (string, обязательный): UUID дашборда для обновления.
• dashboard (object, обязательный): Полное тело замены дашборда (та же структура, что и при create).
• metadata (object, необязательный): Замена метаданных. Системные дашборды только для чтения возвращают ошибку 403.

delete_dashboard

• id (string, обязательный): UUID дашборда для удаления. Системные дашборды только для чтения не могут быть удалены.

list_dashboard_snapshots

• dashboard_id (string, обязательный): UUID дашборда, чьи снимки нужно перечислить.

Возвращает только метаданные (id, name, expires_at и т. д.). Используйте get_dashboard_snapshot для замороженных данных панелей.

get_dashboard_snapshot

• id (string, обязательный): UUID снимка.

Возвращает полный замороженный снимок, включая dashboard_definition, panel_data, time_range и variables.

delete_dashboard_snapshot

• id (string, обязательный): UUID снимка для удаления.

get_profile_services

• lookback_minutes / start_time_iso / end_time_iso (необязательный): Окно; предпочтительно использовать период просмотра или явные границы ISO (по умолчанию 60 м).
• region (string, необязательный): Переопределение региона.

Возвращает сервисы, имеющие данные профилирования в окне. Вызывайте это перед get_flamegraph / get_top_functions / get_profile_summary.

get_flamegraph

• service (string, обязательный): Имя сервиса из get_profile_services.
• profile_type (string, необязательный): cpu (по умолчанию), alloc или wall. Закрепите тип при сравнении окон.
• env / cluster / namespace / runtime (string, необязательный): Фильтры области.
• limit (number, необязательный): Максимум агрегированных строк стека (по умолчанию 1000, максимум 10000).
• lookback_minutes / start_time_iso / end_time_iso / region (необязательный).

Возвращает вложенное дерево флеймграфа (name / value / self / children). truncated: true означает, что достигнут лимит строк API.

get_top_functions

Те же фильтры, что и в get_flamegraph. Возвращает ранжирование по собственным выборкам самых «горячих» функций. Может быть усечено; проверьте truncated.

get_profile_summary

Те же фильтры, что и в get_flamegraph. Возвращает краткую сортировку профиля для сервиса на естественном языке.

grafana_search_dashboards

• query (string, необязательный): Подстрока заголовка. Пустое значение ищет широко (с учётом ограничения в 5000 строк).

Возвращает {"dashboards":[…], "truncated":bool} с uid, title, uri, url, type, tags. Используйте uid с grafana_get_dashboard.

grafana_get_dashboard

• uid (string, обязательный): UID дашборда Grafana.
• full_json (boolean, необязательный): Если true, возвращает необработанный JSON Grafana вместо отфильтрованной сводки. Default summary: version, tags, templating variables, and each panel's type/datasource/gridPos/promQL targets. Unknown plugin panel types appear in unsupportedPanelTypes.

grafana_list_folders

Без параметров. Возвращает дерево папок.

grafana_list_folder_dashboards

• folder_uid (строка, обязательный): UID папки Grafana.

Возвращает {"dashboards":[…], "truncated":bool} для панелей в этой папке (постранично, до 5 000).

grafana_list_datasources

Без параметров. Возвращает безопасную проекцию источников данных (без полей с учетными данными).