Last9

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

Pour NPM : utilisez "command": "npx" et ajoutez "args": ["-y", "@last9/mcp-server@latest"].

Après téléchargement depuis Versions GitHub, extrayez et pointez vers le chemin complet :

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

La voie NPM est plus simple sur Windows — aucune gestion de chemin.

Exécution en mode HTTP

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

Le serveur démarre à http://localhost:8080/mcp.

Test avec curl

Le gestionnaire HTTP Streamable fonctionne en mode sans état, donc toute requête est servie indépendamment. Une poignée de main initialize et un en-tête Mcp-Session-Id sont facultatifs — les clients qui les envoient fonctionnent toujours (l'en-tête est accepté et ignoré), et les clients peuvent aussi passer directement à tools/list / tools/call. Chaque outil est une requête/réponse indépendante ; le serveur n'émet aucune notification serveur→client, donc GET /mcp (le flux SSE) renvoie 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
        }
      }
    }'

Compilation depuis les sources

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 est destiné au développement local. Pour une utilisation réelle, le point de terminaison HTTP hébergé est plus simple.

Saisie de l'heure

• Les heures absolues (start_time_iso/end_time_iso, ou time_iso) ont priorité sur lookback_minutes.
• Pour les fenêtres relatives : utilisez lookback_minutes.
• Pour les fenêtres absolues : utilisez RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• Le YYYY-MM-DD HH:MM:SS hérité est accepté uniquement pour compatibilité.

get_exceptions

• limit (entier, facultatif) : Nombre maximal d'exceptions. Défaut : 20.
• lookback_minutes (entier, facultatif) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif) : Plage horaire absolue.
• service_name (chaîne, facultatif) : Filtrer par service.
• span_name (chaîne, facultatif) : Filtrer par nom de span.
• env (chaîne, facultatif) : Filtrer par environnement.

get_service_summary

• start_time_iso / end_time_iso (chaîne, facultatif)
• env (chaîne, facultatif) : Regex PromQL. Défaut : .*. La correspondance exacte nécessite des ancres (par ex. ^prod$).
• sort_by (chaîne, facultatif) : request_count (défaut), throughput_rpm, http_4xx_count, http_5xx_count ou grpc_error_count.
• limit (entier, facultatif) : Nombre maximal de lignes classées. Omettre ou 0 signifie 10 ; les valeurs supérieures à 100 sont plafonnées à 100.

get_service_environments

• start_time_iso / end_time_iso (chaîne, facultatif)

Tous les autres outils APM nécessitent une valeur env. Utilisez "" si cela renvoie un résultat vide.

get_service_performance_details

• service_name (chaîne, obligatoire)
• lookback_minutes (entier, facultatif) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)
• env (chaîne, facultatif) : Défaut : prod.

get_service_operations_summary

• service_name (chaîne, obligatoire)
• lookback_minutes (entier, facultatif) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)
• env (chaîne, facultatif) : Défaut : prod.

get_service_dependency_graph

• service_name (chaîne, facultatif)
• lookback_minutes (entier, facultatif) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)
• env (chaîne, facultatif) : Défaut : prod.

get_apm_service_deviations

• service_name (chaîne, facultatif) : Omettre pour la portée du parc ; fournir pour un service et ses corrélations d'opérations.
• lookback_minutes (entier, facultatif) : Fenêtre actuelle. Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif) : Fenêtre actuelle explicite.
• baseline_start_time_iso / baseline_end_time_iso (chaîne, facultatif) : Ligne de base explicite. Défaut : la fenêtre de durée égale immédiatement précédente.
• datasource (chaîne, facultatif) : Restreindre la comparaison à une seule source de données.
• env (chaîne, facultatif) : Défaut : prod.
• max_services / max_operations (entier, facultatif) : Défaut 10, maximum 10 chacun.

get_databases

• env (chaîne, facultatif) : Filtrer par environnement. Accepte une expression régulière. Défaut : tous.
• lookback_minutes (entier, facultatif) : Défaut : 60. La fenêtre ne peut pas dépasser 7 jours.
• start_time_iso / end_time_iso (chaîne, facultatif)

get_database_slow_queries

• db_system (chaîne, facultatif) : par ex. postgresql, mysql, mongodb, redis.
• host (chaîne, facultatif) : Hôte de la base de données (net_peer_name).
• service_name (chaîne, facultatif) : Nom du service appelant.
• env (chaîne, facultatif)
• min_duration_ms (flottant, facultatif) : Durée minimale de la requête en ms.
• lookback_minutes (entier, facultatif) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)
• limit (entier, facultatif) : Défaut : 20.

get_database_queries

• db_system (chaîne, facultatif)
• host (chaîne, facultatif)
• service_name (chaîne, facultatif)
• env (chaîne, facultatif)
• lookback_minutes (entier, facultatif) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)
• limit (entier, facultatif) : Défaut : 20.

get_database_server_metrics

• db_system (chaîne, obligatoire) : par ex. postgresql, mysql, mongodb, redis, aerospike.
• host (chaîne, facultatif)
• lookback_minutes (entier, facultatif) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)

prometheus_range_query

• query (chaîne, obligatoire) : La requête PromQL.
• start_time_iso / end_time_iso (chaîne, facultatif) : Défaut : les 60 dernières minutes.
• lookback_minutes (flottant, facultatif) : Défaut : 60.

prometheus_instant_query

• query (chaîne, obligatoire)
• time_iso (chaîne, facultatif) : Défaut : maintenant.
• lookback_minutes (flottant, facultatif)

prometheus_label_values

• match_query (chaîne, facultatif) : Filtre PromQL.
• label (chaîne, obligatoire) : Nom du libellé.
• start_time_iso / end_time_iso (chaîne, facultatif)

prometheus_labels

• match_query (chaîne, facultatif) : Filtre PromQL.
• start_time_iso / end_time_iso (chaîne, facultatif)

get_logs

• logjson_query (tableau, obligatoire) : Requête de pipeline JSON.
• lookback_minutes (entier, facultatif) : Défaut : 5.
• start_time_iso / end_time_iso (chaîne, facultatif)
• limit (entier, facultatif) : Défaut serveur : 5000.
• index (chaîne, facultatif) : physical_index:<name> ou rehydration_index:<block_name>.

Pour l'inventaire des services basé sur les journaux, interrogez d'abord physical_index_service_count :

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

Utilisez service_name comme ServiceName, env comme environnement lorsqu'il est présent, et name comme nom d'index physique. Si name="default", omettez index ; pour un index physique non défini par défaut sélectionné par l'utilisateur, passez index: "physical_index:<name>". Si le backend rejette le filtrage explicite par index physique, réessayez sans index et signalez que le filtrage explicite par index physique n'est pas disponible pour ce backend.

get_service_logs

• service_name (chaîne, obligatoire)
• lookback_minutes (entier, facultatif) : Défaut : 60.
• limit (entier, facultatif) : Défaut : 20.
• env (chaîne, facultatif)
• severity_filters (tableau, facultatif) : par ex. ["error", "warn"]. Logique OU.
• body_filters (tableau, facultatif) : par ex. ["timeout", "failed"]. Logique OU.
• start_time_iso / end_time_iso (chaîne, facultatif)
• index (chaîne, facultatif)

Plusieurs types de filtres se combinent avec ET. Chaque tableau utilise OU en interne. Utilisez d'abord get_logs pour des comptes agrégés larges ; utilisez get_service_logs uniquement après avoir réduit à un service/environnement/index et un petit échantillon.

get_log_attributes

• lookback_minutes (entier, facultatif) : Défaut : 15.
• start_time_iso / end_time_iso (chaîne, facultatif)
• region (chaîne, facultatif)
• index (chaîne, facultatif)

get_log_attributes_for_pipeline

• pipeline (tableau, obligatoire) : Étapes de filtrage antérieures pour limiter la découverte, par ex. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (entier, facultatif) : Défaut : 15.
• start_time_iso / end_time_iso (chaîne, facultatif)
• region (chaîne, facultatif)
• index (chaîne, facultatif)

get_drop_rules

Aucun paramètre. Liste les règles de suppression via GET /otel_settings/drop?region=....

add_drop_rule

• name (chaîne, obligatoire)
• filters (tableau, obligatoire) : Chaque filtre : key, value, operator (equals/not_equals), conjunction (and).
• Les clés de filtre doivent utiliser attributes["key_name"] ou resource.attributes["key_name"] (requis par l'API Last9).
• Crée la règle via POST /otel_settings/drop?region=...&cluster_id=....

get_traces

Utilisez pour les recherches larges et les agrégations. Pour une recherche exacte par ID de trace, utilisez get_service_traces.

• tracejson_query (tableau, obligatoire)
• start_time_iso / end_time_iso (chaîne, facultatif)
• lookback_minutes (entier, facultatif) : Défaut : 60.
• limit (entier, facultatif) : Défaut : 5000.

get_service_traces

Exactement un de trace_id ou service_name est obligatoire.

• trace_id (chaîne, optionnel) : Fenêtre de recherche par défaut : 72 heures.
• service_name (chaîne, optionnel) : Fenêtre de recherche par défaut : 60 min.
• lookback_minutes (entier, optionnel)
• start_time_iso / end_time_iso (chaîne, optionnel)
• limit (entier, optionnel) : Défaut : 10.
• env (chaîne, optionnel)

get_trace_attributes

• lookback_minutes (entier, optionnel) : Défaut : 15.
• start_time_iso / end_time_iso (chaîne, optionnel)
• region (chaîne, optionnel)

get_trace_attributes_for_pipeline

• pipeline (tableau, requis) : Étapes de filtre antérieures pour limiter la découverte, p. ex. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (entier, optionnel) : Défaut : 15.
• start_time_iso / end_time_iso (chaîne, optionnel)
• region (chaîne, optionnel)

get_trace_attribute_values

• tag_name (chaîne, requis) : Nom d'attribut issu de get_trace_attributes (p. ex. resource_department ou attributes['http.method']).
• pipeline (tableau, optionnel) : Étapes de filtre antérieures pour limiter les valeurs ; à omettre pour les valeurs globales.
• lookback_minutes (entier, optionnel) : Défaut : 15.
• start_time_iso / end_time_iso (chaîne, optionnel) : Bornes historiques RFC3339 ; prioritaires sur lookback_minutes.
• region (chaîne, optionnel)

get_trace_attribute_deviations

• comparison_mode (chaîne, requis) : latency, errors ou time.
• service_name (chaîne, requis)
• environment (chaîne, requis) : Valeur exacte de deployment.environment.
• operation (chaîne, optionnel)
• filters (tableau, optionnel) : Conditions de filtre JSON de trace.
• candidate_attributes (tableau, optionnel) : Maximum 8 ; à omettre pour une découverte bornée.
• latency_threshold_ms (nombre, optionnel) : Requis pour le mode latency ; rejeté pour les autres modes.
• start_time_iso / end_time_iso (chaîne, optionnel)
• lookback_minutes (entier, optionnel) : Défaut : 15. Maximum : 15.
• baseline_start_time_iso / baseline_end_time_iso (chaîne, optionnel) : Requis pour le mode time ; non chevauchants et de durée égale à la fenêtre cible.
• minimum_cohort_size (entier, optionnel) : Défaut : 100. Minimum : 20.
• minimum_value_support (entier, optionnel) : Défaut : 20. Minimum : 10.
• limit (entier, optionnel) : Défaut : 10. Maximum : 10.

Nécessite que la capacité backend associée soit activée.

get_trace_waterfall

• trace_id (chaîne, requis)
• environment (chaîne, optionnel)
• start_time_iso / end_time_iso (chaîne, optionnel)
• lookback_minutes (entier, optionnel) : Défaut : 4320 (72 heures).
• selected_span_id (chaîne, optionnel) : Renvoie les attributs, événements et liens pour ce span uniquement.
• max_spans (entier, optionnel) : Défaut : 500. Maximum : 1000.

Renvoie une enveloppe investigation-evidence/v1 ; la cascade se trouve sous data.

get_change_events

• start_time_iso / end_time_iso (chaîne, optionnel)
• lookback_minutes (entier, optionnel) : Défaut : 60.
• service_name (chaîne, optionnel)
• env (chaîne, optionnel)
• event_name (chaîne, optionnel) : Appeler sans ce paramètre d'abord pour obtenir available_event_names.

get_alert_groups

Inventaire configuré des groupes d'alertes Compass pour les audits de changeboard / couverture d'étiquettes. Inclut les groupes sans règles et les groupes non déclenchés. Ne renvoie pas de PromQL.

• alert_group_name / alert_group_type / data_source_name (chaîne, optionnel) : Correspondance de sous-chaîne insensible à la casse.
• team / tier (chaîne, optionnel) : Correspondance exacte insensible à la casse sur les métadonnées configurées.
• label_key + label_value (chaîne, optionnel) : Doivent être définis ensemble. Correspondance exacte insensible à la casse sur une paire metadata.labels — clé et valeur.

Renvoie un JSON compact {"count":N,"groups":[...]} avec id, name, type, entity_class, team, tier, metadata.labels et les comptes de règles. team / labels vide signifie non défini.

get_alert_config

• search_term (chaîne, optionnel) : Recherche en texte libre sur le nom, le groupe, la source de données, les étiquettes.
• rule_name (chaîne, optionnel)
• severity (chaîne, optionnel)
• rule_type (chaîne, optionnel) : static ou anomaly.
• alert_group_name / alert_group_type / data_source_name (chaîne, optionnel)
• tags (tableau, optionnel) : Tous doivent correspondre (logique ET).

get_alerts

• time_iso (chaîne, optionnel) : Heure d'évaluation au format RFC3339.
• window (entier, optionnel) : Fenêtre de recherche en secondes. Défaut : 900. Plage : 60–86400.
• lookback_minutes (entier, optionnel) : Plage : 1–1440.

get_alert_rule_state

• start_time (entier, requis) : Début Unix epoch de la plage (inclusif).
• end_time (entier, requis) : Fin Unix epoch de la plage (inclusif).
• step (entier, requis) : Résolution en secondes entre les échantillons. Le nombre d'échantillons ((end_time - start_time) / step + 1) est plafonné à 100.
• alert_group_id (chaîne, optionnel) : Filtrer par ID de groupe d'alertes.
• rule_name (chaîne, optionnel) : Filtre regex sur le nom de la règle.
• alert_group_name (chaîne, optionnel) : Filtre regex sur le nom du groupe d'alertes.
• label_filters (chaîne, optionnel) : Filtres d'étiquettes key=value séparés par des virgules.
• state (chaîne, optionnel) : Filtrer par état (p. ex. firing).

Renvoie une carte JSON de rule_id -> [{timestamp, is_firing}]. Un horodatage auquel une règle est absente de la réponse en amont est signalé comme is_firing=0 — cela signifie « non observé comme déclenché », et non un état normal confirmé.

get_notification_channels

Aucun paramètre. Renvoie tous les canaux de notification configurés (Slack, PagerDuty, e-mail, webhooks, etc.).

did_you_mean

• query (chaîne, requis) : Le nom à rechercher — partiel, mal orthographié ou abrégé.
• type (chaîne, optionnel) : Restreindre au type d'entité : service, environment, host, database, k8s_deployment, k8s_namespace, job.

Renvoie jusqu'à 3 correspondances les plus proches avec des scores de similarité. Utilisez ceci avant tout appel d'outil où le nom de l'entité est incertain. Si un appel précédent a renvoyé des résultats vides, essayez ceci avant de réessayer.

get_service_profile

• service_name (chaîne, requis) : Service pour lequel dériver un profil de télémétrie.
• datasource (chaîne, optionnel) : Nom de la source de données. À omettre pour la valeur par défaut.

Renvoie un bref résumé d'investigation suivi du profil complet en JSON brut : présence de signaux (logs/traces/metrics comme present, absent ou unknown), langage et runtime, environnements de déploiement, signal_shape de journaux (log_format, severity_set, level_field) et un correctif d'ingestion recommandé le cas échéant. Dérivé en amont et mis en cache avec un TTL d'environ 15 minutes.

Appelez-le avant toute investigation à l'échelle d'un service afin que la sélection d'outils corresponde à la télémétrie réelle du service — ignorez les outils de trace lorsque traces est absent, et lorsque severity_set est none ou partial, analysez la sévérité à partir de level_field dans le corps du journal plutôt que d'utiliser severity_filters. metrics est toujours unknown et dependencies n'est pas renseigné en v1. Lorsque logs et traces sont tous deux absent, confirmez le nom avec did_you_mean avant de conclure que le service n'est pas surveillé.

list_dashboards

Aucun paramètre. Renvoie tous les tableaux de bord personnalisés de l'organisation sous forme de tableau JSON avec id, name et les métadonnées.

get_dashboard

• id (chaîne, requis) : UUID du tableau de bord.
• region (chaîne, optionnel) : Région pour le remplissage des requêtes de panneaux. Par défaut, région de la source de données configurée.

validate_dashboard

Lecture seule. Ne crée ni ne met jamais à jour de tableaux de bord. Accepte exactement un de dashboard_id ou dashboard_definition.

• dashboard_id (chaîne, optionnel) : UUID du tableau de bord enregistré à valider.
• dashboard_definition (objet, optionnel) : Corps de tableau de bord non enregistré en ligne (vrai essai à blanc).
• start_time_iso / end_time_iso (chaîne, optionnel) : Fenêtre de validation (RFC3339). Doit être ≤ 24 h.
• region (chaîne, optionnel) : Région pour l'exécution des requêtes de panneaux.

Renvoie dashboard_validation/v1 : classification lint + exécution par panneau (data / no_data / invalid / error). Les résultats vides au jour 1 sont classés comme valid_no_data sans sondes de diagnostic.

create_dashboard

Uniquement nouveau. Après que cet appel renvoie dashboard.id, affinez avec update_dashboard — ne recréez pas pour ajouter, réduire ou corriger des panneaux.

• dashboard (objet, requis) : Définition du tableau de bord avec name et panels[]. Chaque panneau nécessite name, version, layout (x, y, w, h), visualization.type et queries[].
• metadata (objet, optionnel) : Métadonnées du tableau de bord — champs _category et _type (p. ex. {"_category":"custom","_type":"metrics"}).

update_dashboard

À privilégier après create. Remplacement complet par identifiant (même corps que create).

• id (chaîne, requis) : UUID du tableau de bord à mettre à jour.
• dashboard (objet, requis) : Corps complet de remplacement du tableau de bord (même forme que create).
• metadata (objet, optionnel) : Métadonnées de remplacement. Les tableaux de bord système en lecture seule renvoient une erreur 403.

delete_dashboard

• id (chaîne, requis) : UUID du tableau de bord à supprimer. Les tableaux de bord système en lecture seule ne peuvent pas être supprimés.

list_dashboard_snapshots

• dashboard_id (chaîne, requis) : UUID du tableau de bord dont les instantanés doivent être listés.

Renvoie uniquement les métadonnées (id, name, expires_at, etc.). Utilisez get_dashboard_snapshot pour les données de panneaux figées.

get_dashboard_snapshot

• id (chaîne, requis) : UUID de l'instantané.

Renvoie l'instantané figé complet, y compris dashboard_definition, panel_data, time_range et variables.

delete_dashboard_snapshot

• id (chaîne, requis) : UUID de l'instantané à supprimer.

get_profile_services

• lookback_minutes / start_time_iso / end_time_iso (optionnel) : Fenêtre ; préférez la fenêtre de recherche ou des bornes ISO explicites (défaut 60 min).
• region (chaîne, optionnel) : Remplacement de région.

Renvoie les services qui ont des données de profilage dans la fenêtre. Appelez ceci avant get_flamegraph / get_top_functions / get_profile_summary.

get_flamegraph

• service (chaîne, requis) : Nom du service issu de get_profile_services.
• profile_type (chaîne, optionnel) : cpu (défaut), alloc ou wall. Épinglez un type lors de la comparaison de fenêtres.
• env / cluster / namespace / runtime (chaîne, optionnel) : Filtres de portée.
• limit (nombre, optionnel) : Nombre maximal de lignes de pile agrégées (défaut 1000, max 10000).
• lookback_minutes / start_time_iso / end_time_iso / region (optionnel).

Renvoie un arbre de flamegraph imbriqué (name / value / self / children). truncated: true signifie que la limite de lignes de l'API a été atteinte.

get_top_functions

Mêmes filtres que get_flamegraph. Renvoie le classement des échantillons propres des fonctions les plus actives. Peut être tronqué ; vérifiez truncated.

get_profile_summary

Mêmes filtres que get_flamegraph. Renvoie un court triage en langage naturel du profil pour le service.

grafana_search_dashboards

• query (chaîne, optionnel) : Sous-chaîne du titre. Vide liste largement (sous réserve de la limite de 5 000 lignes).

Renvoie {"dashboards":[…], "truncated":bool} avec uid, title, uri, url, type, tags. Utilisez uid avec grafana_get_dashboard.

grafana_get_dashboard

• uid (chaîne, requis) : UID du tableau de bord Grafana.
• full_json (booléen, optionnel) : Lorsque vrai, renvoie le JSON Grafana brut au lieu du résumé filtré. Résumé par défaut : version, tags, variables de templating, et le type/datasource/gridPos/cibles promQL de chaque panneau. Les types de panneaux de plugin inconnus apparaissent dans unsupportedPanelTypes.

grafana_list_folders

Aucun paramètre. Renvoie l'arborescence des dossiers.

grafana_list_folder_dashboards

• folder_uid (chaîne, obligatoire) : uid du dossier Grafana.

Renvoie {"dashboards":[…], "truncated":bool} pour les tableaux de bord de ce dossier (paginé jusqu'à 5 000).

grafana_list_datasources

Aucun paramètre. Renvoie une projection sûre des sources de données (sans champs d'identifiants).