Last9 MCP Server

{
  "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 avoir téléchargé depuis GitHub Releases, 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 méthode NPM est plus simple sous Windows — pas de gestion de chemin.

Exécuter 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 sur http://localhost:8080/mcp.

Tester avec curl

Le HTTP diffusé MCP nécessite d'abord une poignée de main d'initialisation. Ne définissez pas Mcp-Session-Id lors de la première requête.

# Step 1: Initialize
SESSION_ID=$(curl -si -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "initialize",
      "params": {
        "protocolVersion": "2024-11-05",
        "capabilities": {},
        "clientInfo": {"name": "curl-test", "version": "1.0"}
      }
    }' | grep -i "^Mcp-Session-Id:" | awk '{print $2}' | tr -d '\r')
echo "Session: $SESSION_ID"

# Step 2: Send initialized notification
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Mcp-Session-Id: $SESSION_ID" \
    -d '{"jsonrpc": "2.0", "method": "notifications/initialized", "params": {}}'

# Step 3: List tools
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Mcp-Session-Id: $SESSION_ID" \
    -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}'

# Step 4: Call a tool
curl -s -X POST http://localhost:8080/mcp \
    -H "Content-Type: application/json" \
    -H "Mcp-Session-Id: $SESSION_ID" \
    -d '{
      "jsonrpc": "2.0",
      "id": 3,
      "method": "tools/call",
      "params": {
        "name": "get_service_logs",
        "arguments": {
          "service": "your-service-name",
          "lookback_minutes": 30,
          "limit": 10
        }
      }
    }'

Construire depuis la source

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

Saisie de temps

• 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.
• L'héritage YYYY-MM-DD HH:MM:SS est accepté uniquement pour compatibilité.

get_exceptions

• limit (entier, optionnel) : Exceptions max. Défaut : 20.
• lookback_minutes (entier, optionnel) : Défaut : 60.
• start_time_iso / end_time_iso (chaîne, optionnel) : Plage temporelle absolue.
• service_name (chaîne, optionnel) : Filtrer par service.
• span_name (chaîne, optionnel) : Filtrer par nom de span.
• deployment_environment (chaîne, optionnel) : Filtrer par environnement.

get_service_summary

• start_time_iso / end_time_iso (chaîne, optionnel)
• env (chaîne, optionnel) : Défaut à prod.

get_service_environments

• start_time_iso / end_time_iso (chaîne, optionnel)

Tous les autres outils APM nécessitent une valeur env. Utilisez "" si ceci ne renvoie rien.

get_service_performance_details

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

get_service_operations_summary

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

get_service_dependency_graph

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

get_databases

• env (chaîne, facultatif) : Filtrer par environnement. Par défaut : tous.
• lookback_minutes (entier, facultatif) : Par défaut : 60.
• 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) : Par défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)
• limit (entier, facultatif) : Par 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) : Par défaut : 60.
• start_time_iso / end_time_iso (chaîne, facultatif)
• limit (entier, facultatif) : Par 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) : Par 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) : Par défaut, les 60 dernières minutes.
• lookback_minutes (flottant, facultatif) : Par défaut : 60.

prometheus_instant_query

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

prometheus_label_values

• match_query (chaîne, facultatif) : Filtre PromQL.
• label (chaîne, obligatoire) : Nom de l'étiquette.
• 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) : Par défaut : 5.
• start_time_iso / end_time_iso (chaîne, facultatif)
• limit (entier, facultatif) : Valeur par défaut du serveur : 5000.
• index (chaîne, facultatif) : physical_index:<name> ou rehydration_index:<block_name>.

Pour l'inventaire des services basé sur les logs, 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 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 (chaîne, obligatoire)
• lookback_minutes (entier, facultatif) : Par défaut : 60.
• limit (entier, facultatif) : Par 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 comptages agrégés larges ; utilisez get_service_logs seulement après avoir restreint à un service/environnement/index et à un petit échantillon.

get_log_attributes

• lookback_minutes (entier, facultatif) : Par 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 filtre préalables pour délimiter la découverte, par ex. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (entier, facultatif) : Par 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.

add_drop_rule

• name (chaîne, obligatoire)
• filters (tableau, obligatoire) : Chaque filtre : key, value, operator (equals/not_equals), conjunction (and).

get_traces

À utiliser pour les recherches larges et les agrégations. Pour une recherche par ID de trace exact, utilisez get_service_traces.

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

get_service_traces

Exactement l'un de trace_id ou service_name est obligatoire.

• trace_id (chaîne, facultatif) : Période de recherche par défaut : 72 heures.
• service_name (chaîne, facultatif) : Période de recherche par défaut : 60 min.
• lookback_minutes (entier, facultatif)
• start_time_iso / end_time_iso (chaîne, facultatif)
• limit (entier, facultatif) : Par défaut : 10.
• env (chaîne, facultatif)

get_trace_attributes

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

get_trace_attributes_for_pipeline

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

get_trace_attribute_values

• tag_name (chaîne, obligatoire) : Nom de l'attribut provenant de get_trace_attributes (par ex. resource_department ou attributes['http.method']).
• pipeline (tableau, facultatif) : Étapes de filtre préalables pour délimiter les valeurs ; omettez pour les valeurs globales.
• region (chaîne, facultatif)

get_change_events

• start_time_iso / end_time_iso (chaîne, facultatif)
• lookback_minutes (entier, facultatif) : Par défaut : 60.
• service (chaîne, facultatif)
• environment (chaîne, facultatif)
• event_name (chaîne, facultatif) : Appelez d'abord sans ceci pour obtenir available_event_names.

get_alert_config

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

get_alerts

• time_iso (chaîne, facultatif) : Heure d'évaluation au format RFC3339.
• window (entier, facultatif) : Période de recherche en secondes. Par défaut : 900. Plage : 60–86400.
• lookback_minutes (entier, facultatif) : Plage : 1–1440.

get_alert_rule_state

• start_time (entier, obligatoire) : Début de la plage en époque Unix (inclusif).
• end_time (entier, obligatoire) : Fin de la plage en époque Unix (inclusif).
• step (entier, obligatoire) : 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, facultatif) : Filtrer par ID de groupe d'alertes.
• rule_name (chaîne, facultatif) : Filtre par expression régulière sur le nom de la règle.
• alert_group_name (chaîne, facultatif) : Filtre par expression régulière sur le nom du groupe d'alertes.
• label_filters (chaîne, facultatif) : Filtres d'étiquettes key=value séparés par des virgules.
• state (chaîne, facultatif) : Filtrer par état (par ex. firing).

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

get_notification_channels

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

did_you_mean

• query (chaîne, obligatoire) : Le nom à rechercher — partiel, mal orthographié ou abrégé.
• type (chaîne, facultatif) : 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.

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, obligatoire) : UUID du tableau de bord.
• region (chaîne, facultatif) : Région pour le peuplement des requêtes des panneaux. Par défaut, la région de la source de données configurée.

create_dashboard

• dashboard (objet, obligatoire) : 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, facultatif) : Métadonnées du tableau de bord — champs _category et _type (par ex. {"_category":"custom","_type":"metrics"}).

update_dashboard

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

delete_dashboard

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