Last9 MCP Server

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

Para NPM: usa "command": "npx" y añade "args": ["-y", "@last9/mcp-server@latest"].

Después de descargar desde Lanzamientos de GitHub, extrae y apunta a la ruta completa:

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

La ruta de NPM es más fácil en Windows — sin gestión de rutas.

Ejecutar en Modo HTTP

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

El servidor se inicia en http://localhost:8080/mcp.

Probar con curl

MCP Streamable HTTP requiere un handshake de inicialización primero. No establezcas Mcp-Session-Id en la primera solicitud.

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

Compilar desde Fuente

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 es para desarrollo local. Para uso real, el endpoint HTTP alojado es más fácil.

Entrada de Tiempo

• Los tiempos absolutos (start_time_iso/end_time_iso, o time_iso) tienen prioridad sobre lookback_minutes.
• Para ventanas relativas: usa lookback_minutes.
• Para ventanas absolutas: usa RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• YYYY-MM-DD HH:MM:SS heredado se acepta solo por compatibilidad.

get_exceptions

• limit (entero, opcional): Máximo de excepciones. Predeterminado: 20.
• lookback_minutes (entero, opcional): Predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional): Rango de tiempo absoluto.
• service_name (cadena, opcional): Filtrar por servicio.
• span_name (cadena, opcional): Filtrar por nombre de span.
• deployment_environment (cadena, opcional): Filtrar por entorno.

get_service_summary

• start_time_iso / end_time_iso (cadena, opcional)
• env (cadena, opcional): Predeterminado a prod.

get_service_environments

• start_time_iso / end_time_iso (cadena, opcional)

Todas las demás herramientas APM requieren un valor env. Usa "" si esto devuelve vacío.

get_service_performance_details

• service_name (cadena, requerido)
• lookback_minutes (entero, opcional): Predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional)
• env (cadena, opcional): Predeterminado a prod.

get_service_operations_summary

• service_name (cadena, obligatorio)
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional)
• env (cadena, opcional): Valor predeterminado: prod.

get_service_dependency_graph

• service_name (cadena, opcional)
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional)
• env (cadena, opcional): Valor predeterminado: prod.

get_databases

• env (cadena, opcional): Filtrar por entorno. Valor predeterminado: todos.
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional)

get_database_slow_queries

• db_system (cadena, opcional): p. ej. postgresql, mysql, mongodb, redis.
• host (cadena, opcional): Host de la base de datos (net_peer_name).
• service_name (cadena, opcional): Nombre del servicio que realiza la llamada.
• env (cadena, opcional)
• min_duration_ms (flotante, opcional): Duración mínima de la consulta en ms.
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional)
• limit (entero, opcional): Valor predeterminado: 20.

get_database_queries

• db_system (cadena, opcional)
• host (cadena, opcional)
• service_name (cadena, opcional)
• env (cadena, opcional)
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional)
• limit (entero, opcional): Valor predeterminado: 20.

get_database_server_metrics

• db_system (cadena, obligatorio): p. ej. postgresql, mysql, mongodb, redis, aerospike.
• host (cadena, opcional)
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• start_time_iso / end_time_iso (cadena, opcional)

prometheus_range_query

• query (cadena, obligatorio): La consulta PromQL.
• start_time_iso / end_time_iso (cadena, opcional): Valor predeterminado: últimos 60 min.
• lookback_minutes (flotante, opcional): Valor predeterminado: 60.

prometheus_instant_query

• query (cadena, obligatorio)
• time_iso (cadena, opcional): Valor predeterminado: ahora.
• lookback_minutes (flotante, opcional)

prometheus_label_values

• match_query (cadena, opcional): Filtro PromQL.
• label (cadena, obligatorio): Nombre de la etiqueta.
• start_time_iso / end_time_iso (cadena, opcional)

prometheus_labels

• match_query (cadena, opcional): Filtro PromQL.
• start_time_iso / end_time_iso (cadena, opcional)

get_logs

• logjson_query (arreglo, obligatorio): Consulta de pipeline en JSON.
• lookback_minutes (entero, opcional): Valor predeterminado: 5.
• start_time_iso / end_time_iso (cadena, opcional)
• limit (entero, opcional): Valor predeterminado del servidor: 5000.
• index (cadena, opcional): physical_index:<name> o rehydration_index:<block_name>.

Para el inventario de servicios basado en logs, consulta primero physical_index_service_count:

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

Usa service_name como ServiceName, env como el entorno cuando esté presente y name como el nombre del índice físico. Si name="default", omite index; para un índice físico no predeterminado seleccionado por el usuario, pasa index: "physical_index:<name>". Si el backend rechaza el filtrado explícito por índice físico, reintenta sin index e informa que el filtrado explícito por índice físico no está disponible para ese backend.

get_service_logs

• service (cadena, obligatorio)
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• limit (entero, opcional): Valor predeterminado: 20.
• env (cadena, opcional)
• severity_filters (arreglo, opcional): p. ej. ["error", "warn"]. Lógica OR.
• body_filters (arreglo, opcional): p. ej. ["timeout", "failed"]. Lógica OR.
• start_time_iso / end_time_iso (cadena, opcional)
• index (cadena, opcional)

Múltiples tipos de filtro se combinan con AND. Cada arreglo usa OR internamente. Usa get_logs primero para recuentos agregados amplios; usa get_service_logs solo después de acotar a un servicio/entorno/índice y un conjunto de muestra pequeño.

get_log_attributes

• lookback_minutes (entero, opcional): Valor predeterminado: 15.
• start_time_iso / end_time_iso (cadena, opcional)
• region (cadena, opcional)
• index (cadena, opcional)

get_log_attributes_for_pipeline

• pipeline (arreglo, obligatorio): Etapas de filtro previas para acotar el descubrimiento, p. ej. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (entero, opcional): Valor predeterminado: 15.
• start_time_iso / end_time_iso (cadena, opcional)
• region (cadena, opcional)
• index (cadena, opcional)

get_drop_rules

Sin parámetros.

add_drop_rule

• name (cadena, obligatorio)
• filters (arreglo, obligatorio): Cada filtro: key, value, operator (equals/not_equals), conjunction (and).

get_traces

Úsalo para búsquedas amplias y agregaciones. Para búsqueda exacta por ID de traza, usa get_service_traces.

• tracejson_query (arreglo, obligatorio)
• start_time_iso / end_time_iso (cadena, opcional)
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• limit (entero, opcional): Valor predeterminado: 5000.

get_service_traces

Se requiere exactamente uno de trace_id o service_name.

• trace_id (cadena, opcional): Ventana de búsqueda predeterminada: 72 horas.
• service_name (cadena, opcional): Ventana de búsqueda predeterminada: 60 min.
• lookback_minutes (entero, opcional)
• start_time_iso / end_time_iso (cadena, opcional)
• limit (entero, opcional): Valor predeterminado: 10.
• env (cadena, opcional)

get_trace_attributes

• lookback_minutes (entero, opcional): Valor predeterminado: 15.
• start_time_iso / end_time_iso (cadena, opcional)
• region (cadena, opcional)

get_trace_attributes_for_pipeline

• pipeline (arreglo, obligatorio): Etapas de filtro previas para acotar el descubrimiento, p. ej. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (entero, opcional): Valor predeterminado: 15.
• start_time_iso / end_time_iso (cadena, opcional)
• region (cadena, opcional)

get_trace_attribute_values

• tag_name (cadena, obligatorio): Nombre del atributo de get_trace_attributes (p. ej. resource_department o attributes['http.method']).
• pipeline (arreglo, opcional): Etapas de filtro previas para acotar los valores; omítelo para valores globales.
• region (cadena, opcional)

get_change_events

• start_time_iso / end_time_iso (cadena, opcional)
• lookback_minutes (entero, opcional): Valor predeterminado: 60.
• service (cadena, opcional)
• environment (cadena, opcional)
• event_name (cadena, opcional): Llama sin esto primero para obtener available_event_names.

get_alert_config

• search_term (cadena, opcional): Búsqueda de texto libre en nombre, grupo, fuente de datos, etiquetas.
• rule_name (cadena, opcional)
• severity (cadena, opcional)
• rule_type (cadena, opcional): static o anomaly.
• alert_group_name / alert_group_type / data_source_name (cadena, opcional)
• tags (arreglo, opcional): Todas deben coincidir (lógica AND).

get_alerts

• time_iso (cadena, opcional): Hora de evaluación en RFC3339.
• window (entero, opcional): Ventana de búsqueda en segundos. Valor predeterminado: 900. Rango: 60–86400.
• lookback_minutes (entero, opcional): Rango: 1–1440.

get_alert_rule_state

• start_time (entero, obligatorio): Inicio del rango en epoch Unix (inclusivo).
• end_time (entero, obligatorio): Fin del rango en epoch Unix (inclusivo).
• step (entero, obligatorio): Resolución en segundos entre muestras. El número de muestras ((end_time - start_time) / step + 1) está limitado a 100.
• alert_group_id (cadena, opcional): Filtrar por ID de grupo de alertas.
• rule_name (cadena, opcional): Filtro regex sobre el nombre de la regla.
• alert_group_name (cadena, opcional): Filtro regex sobre el nombre del grupo de alertas.
• label_filters (cadena, opcional): Filtros de etiquetas key=value separados por comas.
• state (cadena, opcional): Filtrar por estado (p. ej. firing).

Devuelve un mapa JSON de rule_id -> [{timestamp, is_firing}]. Una marca de tiempo en la que una regla está ausente de la respuesta del upstream se reporta como is_firing=0 — esto significa "no se observó en estado de disparo", no un estado normal confirmado.

get_notification_channels

Sin parámetros. Devuelve todos los canales de notificación configurados (Slack, PagerDuty, correo electrónico, webhooks, etc.).

did_you_mean

• query (cadena, obligatorio): El nombre a buscar — parcial, mal escrito o abreviado.
• type (cadena, opcional): Restringir al tipo de entidad: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Devuelve hasta 3 coincidencias más cercanas con puntuaciones de similitud. Úsalo antes de cualquier llamada a herramienta donde el nombre de la entidad sea incierto. Si una llamada anterior devolvió resultados vacíos, prueba esto antes de reintentar.

list_dashboards

Sin parámetros. Devuelve todos los dashboards personalizados en la organización como un arreglo JSON con id, name y metadatos.

get_dashboard

• id (cadena, obligatorio): UUID del dashboard.
• region (cadena, opcional): Región para la población de consultas del panel. Valor predeterminado: región de la fuente de datos configurada.

create_dashboard

• dashboard (objeto, obligatorio): Definición del dashboard con name y panels[]. Cada panel requiere name, version, layout (x, y, w, h), visualization.type y queries[].
• metadata (objeto, opcional): Metadatos del dashboard — campos _category y _type (p. ej. {"_category":"custom","_type":"metrics"}).

update_dashboard

• id (cadena, obligatorio): UUID del dashboard a actualizar.
• dashboard (objeto, obligatorio): Cuerpo completo de reemplazo del dashboard (misma estructura que en la creación).
• metadata (objeto, opcional): Metadatos de reemplazo. Los dashboards de sistema de solo lectura devuelven un error 403.

delete_dashboard

• id (cadena, obligatorio): UUID del dashboard a eliminar. Los dashboards de sistema de solo lectura no se pueden eliminar.