Last9 MCP Server

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

Para NPM: use "command": "npx" e adicione "args": ["-y", "@last9/mcp-server@latest"].

Após baixar de Lançamentos do GitHub, extraia e aponte para o caminho completo:

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

A rota NPM é mais fácil no Windows — sem gerenciamento de caminho.

Executar em Modo HTTP

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

O servidor inicia em http://localhost:8080/mcp.

Testar com curl

MCP Streamable HTTP requer um handshake de inicialização primeiro. Não defina Mcp-Session-Id na primeira requisição.

# 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 a Partir do Código Fonte

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 é para desenvolvimento local. Para uso real, o endpoint HTTP hospedado é mais fácil.

Entrada de Tempo

• Tempos absolutos (start_time_iso/end_time_iso, ou time_iso) têm precedência sobre lookback_minutes.
• Para janelas relativas: use lookback_minutes.
• Para janelas absolutas: use RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• O legado YYYY-MM-DD HH:MM:SS é aceito apenas para compatibilidade.

get_exceptions

• limit (inteiro, opcional): Máximo de exceções. Padrão: 20.
• lookback_minutes (inteiro, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional): Intervalo de tempo absoluto.
• service_name (string, opcional): Filtrar por serviço.
• span_name (string, opcional): Filtrar por nome do span.
• deployment_environment (string, opcional): Filtrar por ambiente.

get_service_summary

• start_time_iso / end_time_iso (string, opcional)
• env (string, opcional): Padrão prod.

get_service_environments

• start_time_iso / end_time_iso (string, opcional)

Todas as outras ferramentas APM requerem um valor env. Use "" se isso retornar vazio.

get_service_performance_details

• service_name (string, obrigatório)
• lookback_minutes (inteiro, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional)
• env (string, opcional): Padrão prod.

get_service_operations_summary

• service_name (string, obrigatório)
• lookback_minutes (integer, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional)
• env (string, opcional): Padrão: prod.

get_service_dependency_graph

• service_name (string, opcional)
• lookback_minutes (integer, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional)
• env (string, opcional): Padrão: prod.

get_databases

• env (string, opcional): Filtrar por ambiente. Padrão: todos.
• lookback_minutes (integer, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional)

get_database_slow_queries

• db_system (string, opcional): ex.: postgresql, mysql, mongodb, redis.
• host (string, opcional): Host do banco de dados (net_peer_name).
• service_name (string, opcional): Nome do serviço chamador.
• env (string, opcional)
• min_duration_ms (float, opcional): Duração mínima da consulta em ms.
• lookback_minutes (integer, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional)
• limit (integer, opcional): Padrão: 20.

get_database_queries

• db_system (string, opcional)
• host (string, opcional)
• service_name (string, opcional)
• env (string, opcional)
• lookback_minutes (integer, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional)
• limit (integer, opcional): Padrão: 20.

get_database_server_metrics

• db_system (string, obrigatório): ex.: postgresql, mysql, mongodb, redis, aerospike.
• host (string, opcional)
• lookback_minutes (integer, opcional): Padrão: 60.
• start_time_iso / end_time_iso (string, opcional)

prometheus_range_query

• query (string, obrigatório): A consulta PromQL.
• start_time_iso / end_time_iso (string, opcional): Padrão: últimos 60 min.
• lookback_minutes (float, opcional): Padrão: 60.

prometheus_instant_query

• query (string, obrigatório)
• time_iso (string, opcional): Padrão: agora.
• lookback_minutes (float, opcional)

prometheus_label_values

• match_query (string, opcional): Filtro PromQL.
• label (string, obrigatório): Nome do rótulo.
• start_time_iso / end_time_iso (string, opcional)

prometheus_labels

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

get_logs

• logjson_query (array, obrigatório): Consulta de pipeline JSON.
• lookback_minutes (integer, opcional): Padrão: 5.
• start_time_iso / end_time_iso (string, opcional)
• limit (integer, opcional): Padrão do servidor: 5000.
• index (string, opcional): physical_index:<name> ou rehydration_index:<block_name>.

Para inventário de serviços baseado em logs, consulte physical_index_service_count primeiro:

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

Use service_name como ServiceName, env como o ambiente quando presente e name como o nome do índice físico. Se name="default", omita index; para um índice físico não padrão selecionado pelo usuário, passe index: "physical_index:<name>". Se o backend rejeitar a filtragem explícita por índice físico, tente novamente sem index e informe que a filtragem explícita por índice físico não está disponível para esse backend.

get_service_logs

• service (string, obrigatório)
• lookback_minutes (integer, opcional): Padrão: 60.
• limit (integer, opcional): Padrão: 20.
• env (string, opcional)
• severity_filters (array, opcional): ex.: ["error", "warn"]. Lógica OU.
• body_filters (array, opcional): ex.: ["timeout", "failed"]. Lógica OU.
• start_time_iso / end_time_iso (string, opcional)
• index (string, opcional)

Múltiplos tipos de filtro são combinados com E. Cada array usa OU internamente. Use get_logs para contagens agregadas amplas primeiro; use get_service_logs somente após restringir a um serviço/ambiente/índice e um pequeno conjunto de amostras.

get_log_attributes

• lookback_minutes (integer, opcional): Padrão: 15.
• start_time_iso / end_time_iso (string, opcional)
• region (string, opcional)
• index (string, opcional)

get_log_attributes_for_pipeline

• pipeline (array, obrigatório): Estágios de filtro anteriores para escopo da descoberta, ex.: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opcional): Padrão: 15.
• start_time_iso / end_time_iso (string, opcional)
• region (string, opcional)
• index (string, opcional)

get_drop_rules

Sem parâmetros.

add_drop_rule

• name (string, obrigatório)
• filters (array, obrigatório): Cada filtro: key, value, operator (equals/not_equals), conjunction (and).

get_traces

Use para buscas amplas e agregações. Para busca exata por ID de trace, use get_service_traces.

• tracejson_query (array, obrigatório)
• start_time_iso / end_time_iso (string, opcional)
• lookback_minutes (integer, opcional): Padrão: 60.
• limit (integer, opcional): Padrão: 5000.

get_service_traces

Exatamente um de trace_id ou service_name é obrigatório.

• trace_id (string, opcional): Janela de busca padrão: 72 horas.
• service_name (string, opcional): Janela de busca padrão: 60 min.
• lookback_minutes (integer, opcional)
• start_time_iso / end_time_iso (string, opcional)
• limit (integer, opcional): Padrão: 10.
• env (string, opcional)

get_trace_attributes

• lookback_minutes (integer, opcional): Padrão: 15.
• start_time_iso / end_time_iso (string, opcional)
• region (string, opcional)

get_trace_attributes_for_pipeline

• pipeline (array, obrigatório): Estágios de filtro anteriores para escopo da descoberta, ex.: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opcional): Padrão: 15.
• start_time_iso / end_time_iso (string, opcional)
• region (string, opcional)

get_trace_attribute_values

• tag_name (string, obrigatório): Nome do atributo de get_trace_attributes (ex.: resource_department ou attributes['http.method']).
• pipeline (array, opcional): Estágios de filtro anteriores para escopo dos valores; omita para valores globais.
• region (string, opcional)

get_change_events

• start_time_iso / end_time_iso (string, opcional)
• lookback_minutes (integer, opcional): Padrão: 60.
• service (string, opcional)
• environment (string, opcional)
• event_name (string, opcional): Chame sem isso primeiro para obter available_event_names.

get_alert_config

• search_term (string, opcional): Busca por texto livre em nome, grupo, fonte de dados, tags.
• rule_name (string, opcional)
• severity (string, opcional)
• rule_type (string, opcional): static ou anomaly.
• alert_group_name / alert_group_type / data_source_name (string, opcional)
• tags (array, opcional): Todos devem corresponder (lógica E).

get_alerts

• time_iso (string, opcional): Horário de avaliação em RFC3339.
• window (integer, opcional): Janela de busca em segundos. Padrão: 900. Intervalo: 60–86400.
• lookback_minutes (integer, opcional): Intervalo: 1–1440.

get_alert_rule_state

• start_time (integer, obrigatório): Início do intervalo em epoch Unix (inclusivo).
• end_time (integer, obrigatório): Fim do intervalo em epoch Unix (inclusivo).
• step (integer, obrigatório): Resolução em segundos entre amostras. O número de amostras ((end_time - start_time) / step + 1) é limitado a 100.
• alert_group_id (string, opcional): Filtrar por ID do grupo de alertas.
• rule_name (string, opcional): Filtro regex no nome da regra.
• alert_group_name (string, opcional): Filtro regex no nome do grupo de alertas.
• label_filters (string, opcional): Filtros de rótulo key=value separados por vírgula.
• state (string, opcional): Filtrar por estado (ex.: firing).

Retorna um mapa JSON de rule_id -> [{timestamp, is_firing}]. Um timestamp em que uma regra está ausente da resposta upstream é reportado como is_firing=0 — isso significa "não observado como em disparo", não um estado normal confirmado.

get_notification_channels

Sem parâmetros. Retorna todos os canais de notificação configurados (Slack, PagerDuty, email, webhooks, etc.).

did_you_mean

• query (string, obrigatório): O nome a ser pesquisado — parcial, com erro de ortografia ou abreviado.
• type (string, opcional): Restringir ao tipo de entidade: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Retorna até 3 correspondências mais próximas com pontuações de similaridade. Use isso antes de qualquer chamada de ferramenta onde o nome da entidade seja incerto. Se uma chamada anterior retornou resultados vazios, tente isso antes de tentar novamente.

list_dashboards

Sem parâmetros. Retorna todos os dashboards personalizados na organização como um array JSON com id, name e metadados.

get_dashboard

• id (string, obrigatório): UUID do dashboard.
• region (string, opcional): Região para população de consultas do painel. Padrão: região da fonte de dados configurada.

create_dashboard

• dashboard (object, obrigatório): Definição do dashboard com name e panels[]. Cada painel requer name, version, layout (x, y, w, h), visualization.type e queries[].
• metadata (object, opcional): Metadados do dashboard — campos _category e _type (ex.: {"_category":"custom","_type":"metrics"}).

update_dashboard

• id (string, obrigatório): UUID do dashboard a ser atualizado.
• dashboard (object, obrigatório): Corpo completo de substituição do dashboard (mesmo formato da criação).
• metadata (object, opcional): Metadados de substituição. Dashboards de sistema somente leitura retornam um erro 403.

delete_dashboard

• id (string, obrigatório): UUID do dashboard a ser excluído. Dashboards de sistema somente leitura não podem ser excluídos.