Last9 MCP Server

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

Für NPM: Verwenden Sie "command": "npx" und fügen Sie "args": ["-y", "@last9/mcp-server@latest"] hinzu.

Nach dem Herunterladen von GitHub Releases entpacken und auf den vollständigen Pfad verweisen:

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

Der NPM-Weg ist unter Windows einfacher – keine Pfadverwaltung.

Im HTTP-Modus ausführen

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

Server startet unter http://localhost:8080/mcp.

Mit curl testen

MCP Streamable HTTP erfordert zuerst einen Initialisierungs-Handshake. Setzen Sie Mcp-Session-Id nicht bei der ersten Anfrage.

# 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
        }
      }
    }'

Aus dem Quellcode bauen

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 ist für die lokale Entwicklung. Für die tatsächliche Nutzung ist der gehostete HTTP-Endpunkt einfacher.

Zeiteingabe

• Absolute Zeiten (start_time_iso/end_time_iso oder time_iso) haben Vorrang vor lookback_minutes.
• Für relative Fenster: Verwenden Sie lookback_minutes.
• Für absolute Fenster: Verwenden Sie RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• Veraltetes YYYY-MM-DD HH:MM:SS wird nur aus Kompatibilitätsgründen akzeptiert.

get_exceptions

• limit (Ganzzahl, optional): Maximale Ausnahmen. Standard: 20.
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional): Absoluter Zeitbereich.
• service_name (Zeichenkette, optional): Nach Dienst filtern.
• span_name (Zeichenkette, optional): Nach Span-Namen filtern.
• deployment_environment (Zeichenkette, optional): Nach Umgebung filtern.

get_service_summary

• start_time_iso / end_time_iso (Zeichenkette, optional)
• env (Zeichenkette, optional): Standard ist prod.

get_service_environments

• start_time_iso / end_time_iso (Zeichenkette, optional)

Alle anderen APM-Tools benötigen einen env-Wert. Verwenden Sie "", wenn dies leer zurückgibt.

get_service_performance_details

• service_name (Zeichenkette, erforderlich)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• env (Zeichenkette, optional): Standard ist prod.

get_service_operations_summary

• service_name (Zeichenkette, erforderlich)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• env (Zeichenkette, optional): Standardwert ist prod.

get_service_dependency_graph

• service_name (Zeichenkette, optional)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• env (Zeichenkette, optional): Standardwert ist prod.

get_databases

• env (Zeichenkette, optional): Nach Umgebung filtern. Standard: alle.
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional)

get_database_slow_queries

• db_system (Zeichenkette, optional): z. B. postgresql, mysql, mongodb, redis.
• host (Zeichenkette, optional): Datenbank-Host (net_peer_name).
• service_name (Zeichenkette, optional): Name des aufrufenden Dienstes.
• env (Zeichenkette, optional)
• min_duration_ms (Gleitkommazahl, optional): Minimale Abfragedauer in ms.
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• limit (Ganzzahl, optional): Standard: 20.

get_database_queries

• db_system (Zeichenkette, optional)
• host (Zeichenkette, optional)
• service_name (Zeichenkette, optional)
• env (Zeichenkette, optional)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• limit (Ganzzahl, optional): Standard: 20.

get_database_server_metrics

• db_system (Zeichenkette, erforderlich): z. B. postgresql, mysql, mongodb, redis, aerospike.
• host (Zeichenkette, optional)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• start_time_iso / end_time_iso (Zeichenkette, optional)

prometheus_range_query

• query (Zeichenkette, erforderlich): Die PromQL-Abfrage.
• start_time_iso / end_time_iso (Zeichenkette, optional): Standard: letzte 60 Min.
• lookback_minutes (Gleitkommazahl, optional): Standard: 60.

prometheus_instant_query

• query (Zeichenkette, erforderlich)
• time_iso (Zeichenkette, optional): Standard: jetzt.
• lookback_minutes (Gleitkommazahl, optional)

prometheus_label_values

• match_query (Zeichenkette, optional): PromQL-Filter.
• label (Zeichenkette, erforderlich): Label-Name.
• start_time_iso / end_time_iso (Zeichenkette, optional)

prometheus_labels

• match_query (Zeichenkette, optional): PromQL-Filter.
• start_time_iso / end_time_iso (Zeichenkette, optional)

get_logs

• logjson_query (Array, erforderlich): JSON-Pipeline-Abfrage.
• lookback_minutes (Ganzzahl, optional): Standard: 5.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• limit (Ganzzahl, optional): Server-Standard: 5000.
• index (Zeichenkette, optional): physical_index:<name> oder rehydration_index:<block_name>.

Für das logbasierte Service-Inventar zuerst physical_index_service_count abfragen:

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

Verwenden Sie service_name als ServiceName, env als Umgebung, falls vorhanden, und name als physischen Indexnamen. Wenn name="default", lassen Sie index weg; für einen vom Benutzer ausgewählten nicht standardmäßigen physischen Index übergeben Sie index: "physical_index:<name>". Wenn das Backend die explizite physische Indexfilterung ablehnt, wiederholen Sie den Vorgang ohne index und melden Sie, dass die explizite physische Indexfilterung für dieses Backend nicht verfügbar ist.

get_service_logs

• service (Zeichenkette, erforderlich)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• limit (Ganzzahl, optional): Standard: 20.
• env (Zeichenkette, optional)
• severity_filters (Array, optional): z. B. ["error", "warn"]. ODER-Logik.
• body_filters (Array, optional): z. B. ["timeout", "failed"]. ODER-Logik.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• index (Zeichenkette, optional)

Mehrere Filtertypen werden mit UND kombiniert. Jedes Array verwendet intern ODER. Verwenden Sie get_logs zuerst für breite aggregierte Zählungen; verwenden Sie get_service_logs erst, nachdem Sie auf einen Dienst/eine Umgebung/einen Index und eine kleine Stichprobe eingegrenzt haben.

get_log_attributes

• lookback_minutes (Ganzzahl, optional): Standard: 15.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• region (Zeichenkette, optional)
• index (Zeichenkette, optional)

get_log_attributes_for_pipeline

• pipeline (Array, erforderlich): Vorherige Filterstufen zur Eingrenzung der Erkennung, z. B. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (Ganzzahl, optional): Standard: 15.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• region (Zeichenkette, optional)
• index (Zeichenkette, optional)

get_drop_rules

Keine Parameter.

add_drop_rule

• name (Zeichenkette, erforderlich)
• filters (Array, erforderlich): Jeder Filter: key, value, operator (equals/not_equals), conjunction (and).

get_traces

Für breite Suchen und Aggregationen verwenden. Für die exakte Trace-ID-Suche verwenden Sie get_service_traces.

• tracejson_query (Array, erforderlich)
• start_time_iso / end_time_iso (Zeichenkette, optional)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• limit (Ganzzahl, optional): Standard: 5000.

get_service_traces

Genau eines von trace_id oder service_name ist erforderlich.

• trace_id (Zeichenkette, optional): Standard-Rückblick: 72 Stunden.
• service_name (Zeichenkette, optional): Standard-Rückblick: 60 Min.
• lookback_minutes (Ganzzahl, optional)
• start_time_iso / end_time_iso (Zeichenkette, optional)
• limit (Ganzzahl, optional): Standard: 10.
• env (Zeichenkette, optional)

get_trace_attributes

• lookback_minutes (Ganzzahl, optional): Standard: 15.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• region (Zeichenkette, optional)

get_trace_attributes_for_pipeline

• pipeline (Array, erforderlich): Vorherige Filterstufen zur Eingrenzung der Erkennung, z. B. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (Ganzzahl, optional): Standard: 15.
• start_time_iso / end_time_iso (Zeichenkette, optional)
• region (Zeichenkette, optional)

get_trace_attribute_values

• tag_name (Zeichenkette, erforderlich): Attributname aus get_trace_attributes (z. B. resource_department oder attributes['http.method']).
• pipeline (Array, optional): Vorherige Filterstufen zur Eingrenzung der Werte; für globale Werte weglassen.
• region (Zeichenkette, optional)

get_change_events

• start_time_iso / end_time_iso (Zeichenkette, optional)
• lookback_minutes (Ganzzahl, optional): Standard: 60.
• service (Zeichenkette, optional)
• environment (Zeichenkette, optional)
• event_name (Zeichenkette, optional): Rufen Sie dies zuerst ohne diesen Parameter auf, um available_event_names zu erhalten.

get_alert_config

• search_term (Zeichenkette, optional): Freitextsuche über Name, Gruppe, Datenquelle, Tags.
• rule_name (Zeichenkette, optional)
• severity (Zeichenkette, optional)
• rule_type (Zeichenkette, optional): static oder anomaly.
• alert_group_name / alert_group_type / data_source_name (Zeichenkette, optional)
• tags (Array, optional): Alle müssen übereinstimmen (UND-Logik).

get_alerts

• time_iso (Zeichenkette, optional): Auswertungszeit in RFC3339.
• window (Ganzzahl, optional): Rückblick in Sekunden. Standard: 900. Bereich: 60–86400.
• lookback_minutes (Ganzzahl, optional): Bereich: 1–1440.

get_alert_rule_state

• start_time (Ganzzahl, erforderlich): Unix-Epochen-Start des Bereichs (inklusive).
• end_time (Ganzzahl, erforderlich): Unix-Epochen-Ende des Bereichs (inklusive).
• step (Ganzzahl, erforderlich): Auflösung in Sekunden zwischen den Abtastungen. Die Anzahl der Abtastungen ((end_time - start_time) / step + 1) ist auf 100 begrenzt.
• alert_group_id (Zeichenkette, optional): Nach Alarmgruppen-ID filtern.
• rule_name (Zeichenkette, optional): Regex-Filter für den Regelnamen.
• alert_group_name (Zeichenkette, optional): Regex-Filter für den Alarmgruppennamen.
• label_filters (Zeichenkette, optional): Kommagetrennte key=value Label-Filter.
• state (Zeichenkette, optional): Nach Status filtern (z. B. firing).

Gibt eine JSON-Zuordnung von rule_id -> [{timestamp, is_firing}] zurück. Ein Zeitstempel, zu dem eine Regel in der Upstream-Antwort fehlt, wird als is_firing=0 gemeldet – dies bedeutet „nicht als auslösend beobachtet“, nicht einen bestätigten Normalzustand.

get_notification_channels

Keine Parameter. Gibt alle konfigurierten Benachrichtigungskanäle zurück (Slack, PagerDuty, E-Mail, Webhooks usw.).

did_you_mean

• query (Zeichenkette, erforderlich): Der zu suchende Name – teilweise, falsch geschrieben oder abgekürzt.
• type (Zeichenkette, optional): Auf Entitätstyp beschränken: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Gibt bis zu 3 ähnlichste Treffer mit Ähnlichkeitsbewertungen zurück. Verwenden Sie dies vor jedem Werkzeugaufruf, bei dem der Entitätsname unsicher ist. Wenn ein vorheriger Aufruf leere Ergebnisse zurückgab, versuchen Sie dies vor einem erneuten Versuch.

list_dashboards

Keine Parameter. Gibt alle benutzerdefinierten Dashboards in der Organisation als JSON-Array mit id, name und Metadaten zurück.

get_dashboard

• id (Zeichenkette, erforderlich): Dashboard-UUID.
• region (Zeichenkette, optional): Region für die Panel-Abfragepopulation. Standard: konfigurierte Datenquellenregion.

create_dashboard

• dashboard (Objekt, erforderlich): Dashboard-Definition mit name und panels[]. Jedes Panel erfordert name, version, layout (x, y, w, h), visualization.type und queries[].
• metadata (Objekt, optional): Dashboard-Metadaten – Felder _category und _type (z. B. {"_category":"custom","_type":"metrics"}).

update_dashboard

• id (Zeichenkette, erforderlich): Zu aktualisierende Dashboard-UUID.
• dashboard (Objekt, erforderlich): Vollständiger Ersatz-Dashboard-Body (gleiche Form wie beim Erstellen).
• metadata (Objekt, optional): Ersatz-Metadaten. Schreibgeschützte System-Dashboards geben einen 403-Fehler zurück.

delete_dashboard

• id (Zeichenkette, erforderlich): Zu löschende Dashboard-UUID. Schreibgeschützte System-Dashboards können nicht gelöscht werden.