Last9

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

NPM 사용 시: "command": "npx"을 사용하고 "args": ["-y", "@last9/mcp-server@latest"]을 추가하세요.

GitHub Releases에서 다운로드한 후 압축을 풀고 전체 경로를 지정하세요:

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

Windows에서는 NPM 방식이 더 쉽습니다 — 경로 관리가 필요 없습니다.

HTTP 모드로 실행

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

서버가 http://localhost:8080/mcp에서 시작됩니다.

curl로 테스트

Streamable HTTP 핸들러는 무상태(stateless) 모드로 실행되므로 모든 요청이 독립적으로 처리됩니다. initialize 핸드셰이크와 Mcp-Session-Id 헤더는 선택 사항입니다. 이를 전송하는 클라이언트도 정상 작동하며(헤더는 수락된 후 무시됨), 클라이언트는 tools/list / tools/call로 바로 건너뛸 수도 있습니다. 모든 도구는 독립적인 요청/응답 쿼리이며, 서버는 서버→클라이언트 알림을 발행하지 않으므로 GET /mcp(SSE 스트림)는 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
        }
      }
    }'

소스에서 빌드

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은 로컬 개발용입니다. 실제 사용 시에는 호스팅된 HTTP 엔드포인트가 더 간편합니다.

시간 입력

• 절대 시간(start_time_iso/end_time_iso 또는 time_iso)은 lookback_minutes보다 우선합니다.
• 상대 시간 창: lookback_minutes을 사용하세요.
• 절대 시간 창: RFC3339/ISO8601 — 2026-02-09T15:04:05Z을 사용하세요.
• 레거시 YYYY-MM-DD HH:MM:SS은 호환성 목적으로만 허용됩니다.

get_exceptions

• limit(정수, 선택): 최대 예외 수. 기본값: 20.
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택): 절대 시간 범위.
• service_name(문자열, 선택): 서비스로 필터링.
• span_name(문자열, 선택): 스팬 이름으로 필터링.
• env(문자열, 선택): 환경으로 필터링.

get_service_summary

• start_time_iso / end_time_iso(문자열, 선택)
• env(문자열, 선택): PromQL 정규식. 기본값은 .*입니다. 정확히 일치하려면 앵커가 필요합니다(예: ^prod$).
• sort_by(문자열, 선택): request_count(기본값), throughput_rpm, http_4xx_count, http_5xx_count 또는 grpc_error_count.
• limit(정수, 선택): 최대 순위 행 수. 생략하거나 0이면 10을 의미하며, 100을 초과하는 값은 100으로 제한됩니다.

get_service_environments

• start_time_iso / end_time_iso(문자열, 선택)

다른 모든 APM 도구에는 env 값이 필요합니다. 이 결과가 비어 있으면 ""을 사용하세요.

get_service_performance_details

• service_name(문자열, 필수)
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택)
• env(문자열, 선택): 기본값은 prod입니다.

get_service_operations_summary

• service_name(문자열, 필수)
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택)
• env(문자열, 선택): 기본값은 prod입니다.

get_service_dependency_graph

• service_name(문자열, 선택)
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택)
• env(문자열, 선택): 기본값은 prod입니다.

get_apm_service_deviations

• service_name(문자열, 선택): 플릿 범위에서는 생략하고, 단일 서비스 및 해당 운영 상관관계를 보려면 제공하세요.
• lookback_minutes(정수, 선택): 현재 창. 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택): 명시적 현재 창.
• baseline_start_time_iso / baseline_end_time_iso(문자열, 선택): 명시적 기준선. 기본값은 바로 직전의 동일한 기간 창입니다.
• datasource(문자열, 선택): 비교를 단일 데이터소스로 제한합니다.
• env(문자열, 선택): 기본값은 prod입니다.
• max_services / max_operations(정수, 선택): 기본값 10, 각각 최대 10.

get_databases

• env(문자열, 선택): 환경별 필터링. 기본값: 전체.
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택)

get_database_slow_queries

• db_system(문자열, 선택): 예: postgresql, mysql, mongodb, redis.
• host(문자열, 선택): 데이터베이스 호스트(net_peer_name).
• service_name(문자열, 선택): 호출 서비스 이름.
• env(문자열, 선택)
• min_duration_ms(부동소수점, 선택): 최소 쿼리 기간(ms).
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택)
• limit(정수, 선택): 기본값: 20.

get_database_queries

• db_system(문자열, 선택)
• host(문자열, 선택)
• service_name(문자열, 선택)
• env(문자열, 선택)
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택)
• limit(정수, 선택): 기본값: 20.

get_database_server_metrics

• db_system(문자열, 필수): 예: postgresql, mysql, mongodb, redis, aerospike.
• host(문자열, 선택)
• lookback_minutes(정수, 선택): 기본값: 60.
• start_time_iso / end_time_iso(문자열, 선택)

prometheus_range_query

• query(문자열, 필수): PromQL 쿼리.
• start_time_iso / end_time_iso(문자열, 선택): 기본값은 최근 60분.
• lookback_minutes(부동소수점, 선택): 기본값: 60.

prometheus_instant_query

• query(문자열, 필수)
• time_iso(문자열, 선택): 기본값은 현재 시각.
• lookback_minutes(부동소수점, 선택)

prometheus_label_values

• match_query(문자열, 선택): PromQL 필터.
• label(문자열, 필수): 레이블 이름.
• start_time_iso / end_time_iso(문자열, 선택)

prometheus_labels

• match_query(문자열, 선택): PromQL 필터.
• start_time_iso / end_time_iso(문자열, 선택)

get_logs

• logjson_query(배열, 필수): JSON 파이프라인 쿼리.
• lookback_minutes(정수, 선택): 기본값: 5.
• start_time_iso / end_time_iso(문자열, 선택)
• limit(정수, 선택): 서버 기본값: 5000.
• index(문자열, 선택): physical_index:<name> 또는 rehydration_index:<block_name>.

로그 기반 서비스 인벤토리의 경우 먼저 physical_index_service_count을 쿼리하세요:

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

service_name을 ServiceName으로, env을 환경(있는 경우)으로, name을 물리적 인덱스 이름으로 사용하세요. name="default"인 경우 index을 생략하고, 사용자가 선택한 비기본 물리적 인덱스에 대해서는 index: "physical_index:<name>"을 전달하세요. 백엔드가 명시적 물리적 인덱스 필터링을 거부하면 index 없이 재시도하고, 해당 백엔드에서는 명시적 물리적 인덱스 필터링을 사용할 수 없다고 보고하세요.

get_service_logs

• service_name(문자열, 필수)
• lookback_minutes(정수, 선택): 기본값: 60.
• limit(정수, 선택): 기본값: 20.
• env(문자열, 선택)
• severity_filters(배열, 선택): 예: ["error", "warn"]. OR 논리.
• body_filters(배열, 선택): 예: ["timeout", "failed"]. OR 논리.
• start_time_iso / end_time_iso(문자열, 선택)
• index(문자열, 선택)

여러 필터 유형은 AND로 결합됩니다. 각 배열은 내부적으로 OR을 사용합니다. 먼저 get_logs을 사용하여 광범위한 집계 수를 확인하고, 서비스/환경/인덱스 및 소규모 샘플 세트로 범위를 좁힌 후에만 get_service_logs을 사용하세요.

get_log_attributes

• lookback_minutes(정수, 선택): 기본값: 15.
• start_time_iso / end_time_iso(문자열, 선택)
• region(문자열, 선택)
• index(문자열, 선택)

get_log_attributes_for_pipeline

• pipeline(배열, 필수): 탐색 범위를 제한하기 위한 이전 필터 단계(예: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]).
• lookback_minutes(정수, 선택): 기본값: 15.
• start_time_iso / end_time_iso(문자열, 선택)
• region(문자열, 선택)
• index(문자열, 선택)

get_drop_rules

매개변수 없음. GET /otel_settings/drop?region=...을 통해 드롭 규칙을 나열합니다.

add_drop_rule

• name(문자열, 필수)
• filters(배열, 필수): 각 필터: key, value, operator(equals/not_equals), conjunction(and).
• 필터 키는 attributes["key_name"] 또는 resource.attributes["key_name"]을 사용해야 합니다(Last9 API 필수).
• POST /otel_settings/drop?region=...&cluster_id=...을 통해 규칙을 생성합니다.

get_traces

광범위한 검색 및 집계에 사용합니다. 정확한 트레이스 ID 조회에는 get_service_traces을 사용하세요.

• tracejson_query(배열, 필수)
• start_time_iso / end_time_iso(문자열, 선택)
• lookback_minutes(정수, 선택): 기본값: 60.
• limit(정수, 선택): 기본값: 5000.

get_service_traces

trace_id 또는 service_name 중 정확히 하나가 필요합니다.

• trace_id(문자열, 선택): 기본 조회 기간: 72시간.
• service_name(문자열, 선택): 기본 조회 기간: 60분.
• lookback_minutes(정수, 선택)
• start_time_iso / end_time_iso(문자열, 선택)
• limit(정수, 선택): 기본값: 10.
• env(문자열, 선택)

get_trace_attributes

• lookback_minutes(정수, 선택): 기본값: 15.
• start_time_iso / end_time_iso(문자열, 선택)
• region(문자열, 선택)

get_trace_attributes_for_pipeline

• pipeline(배열, 필수): 탐색 범위를 제한하기 위한 이전 필터 단계(예: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]).
• lookback_minutes(정수, 선택): 기본값: 15.
• start_time_iso / end_time_iso(문자열, 선택)
• region(문자열, 선택)

get_trace_attribute_values

• tag_name(문자열, 필수): get_trace_attributes의 속성 이름(예: resource_department 또는 attributes['http.method']).
• pipeline(배열, 선택): 값 범위를 제한하기 위한 이전 필터 단계. 생략하면 전역 값을 사용합니다.
• region(문자열, 선택)

get_trace_attribute_deviations

• comparison_mode(문자열, 필수): latency, errors 또는 time.
• service_name(문자열, 필수)
• environment(문자열, 필수): 정확한 deployment.environment 값.
• operation(문자열, 선택)
• filters(배열, 선택): 트레이스 JSON 필터 조건.
• candidate_attributes(배열, 선택): 최대 8개. 생략하면 제한적 탐색을 수행합니다.
• latency_threshold_ms(숫자, 선택): latency 모드에 필수이며, 다른 모드에서는 거부됩니다.
• start_time_iso / end_time_iso(문자열, 선택)
• lookback_minutes(정수, 선택): 기본값: 15. 최대값: 15.
• baseline_start_time_iso / baseline_end_time_iso(문자열, 선택): time 모드에 필수이며, 대상 창과 겹치지 않고 기간이 동일해야 합니다.
• minimum_cohort_size(정수, 선택): 기본값: 100. 최소값: 20.
• minimum_value_support(정수, 선택): 기본값: 20. 최소값: 10.
• limit(정수, 선택): 기본값: 10. 최대값: 10.

동반 백엔드 기능이 활성화되어 있어야 합니다.

get_trace_waterfall

• trace_id(문자열, 필수)
• environment(문자열, 선택)
• start_time_iso / end_time_iso(문자열, 선택)
• lookback_minutes(정수, 선택): 기본값: 4320(72시간).
• selected_span_id(문자열, 선택): 해당 스팬에 대한 속성, 이벤트 및 링크만 반환합니다.
• max_spans(정수, 선택): 기본값: 500. 최대값: 1000.

investigation-evidence/v1 봉투(envelope)를 반환하며, 워터폴은 data 아래에 있습니다.

get_change_events

• start_time_iso / end_time_iso(문자열, 선택)
• lookback_minutes(정수, 선택): 기본값: 60.
• service_name(문자열, 선택)
• env(문자열, 선택)
• event_name(문자열, 선택): 먼저 이 매개변수 없이 호출하여 available_event_names을 가져옵니다.

get_alert_config

• search_term (문자열, 선택 사항): 이름, 그룹, 데이터 소스, 태그 전반에 대한 자유 텍스트 검색입니다.
• rule_name (문자열, 선택 사항)
• severity (문자열, 선택 사항)
• rule_type (문자열, 선택 사항): static 또는 anomaly.
• alert_group_name / alert_group_type / data_source_name (문자열, 선택 사항)
• tags (배열, 선택 사항): 모두 일치해야 합니다(AND 논리).

알림(get_alerts)

• time_iso (문자열, 선택 사항): RFC3339 형식의 평가 시간.
• window (정수, 선택 사항): 조회 기간(초). 기본값: 900. 범위: 60–86400.
• lookback_minutes (정수, 선택 사항): 범위: 1–1440.

알림 규칙 상태 가져오기(get_alert_rule_state)

• start_time (정수, 필수): 범위 시작의 Unix epoch(포함).
• end_time (정수, 필수): 범위 종료의 Unix epoch(포함).
• step (정수, 필수): 샘플 간 해상도(초). ((end_time - start_time) / step + 1)의 샘플 수는 100으로 제한됩니다.
• alert_group_id (문자열, 선택 사항): 알림 그룹 ID로 필터링.
• rule_name (문자열, 선택 사항): 규칙 이름에 대한 정규식 필터.
• alert_group_name (문자열, 선택 사항): 알림 그룹 이름에 대한 정규식 필터.
• label_filters (문자열, 선택 사항): 쉼표로 구분된 key=value 라벨 필터.
• state (문자열, 선택 사항): 상태로 필터링(예: firing).

rule_id -> [{timestamp, is_firing}]의 JSON 맵을 반환합니다. 업스트림 응답에 규칙이 없는 타임스탬프는 is_firing=0로 보고됩니다. 이는 "발화(불이행)로 관찰되지 않음"을 의미하며, 정상 상태로 확인된 것이 아닙니다.

알림 채널 가져오기(get_notification_channels)

매개변수 없음. 구성된 모든 알림 채널(Slack, PagerDuty, 이메일, 웹훅 등)을 반환합니다.

의도한 것(did_you_mean)

• query (문자열, 필수): 검색할 이름 — 부분적, 오타, 또는 약어.
• type (문자열, 선택 사항): 엔터티 유형으로 제한: service, environment, host, database, k8s_deployment, k8s_namespace, job.

유사도 점수가 있는 최대 3개의 가장 가까운 일치 항목을 반환합니다. 엔터티 이름이 불확실한 도구 호출 전에 이를 사용하세요. 이전 호출이 빈 결과를 반환한 경우, 재시도하기 전에 이 기능을 시도하세요.

대시보드 목록(list_dashboards)

매개변수 없음. 조직의 모든 사용자 지정 대시보드를 id, name 및 메타데이터가 포함된 JSON 배열로 반환합니다.

대시보드 가져오기(get_dashboard)

• id (문자열, 필수): 대시보드 UUID.
• region (문자열, 선택 사항): 패널 쿼리 채우기를 위한 지역. 기본값은 구성된 데이터 소스 지역입니다.

대시보드 생성(create_dashboard)

• dashboard (객체, 필수): name 및 panels[]이 포함된 대시보드 정의. 각 패널에는 name, version, layout (x, y, w, h), visualization.type, queries[]이 필요합니다.
• metadata (객체, 선택 사항): 대시보드 메타데이터 — _category 및 _type 필드(예: {"_category":"custom","_type":"metrics"}).

대시보드 업데이트(update_dashboard)

• id (문자열, 필수): 업데이트할 대시보드 UUID.
• dashboard (객체, 필수): 전체 교체 대시보드 본문(생성과 동일한 형태).
• metadata (객체, 선택 사항): 교체 메타데이터. 읽기 전용 시스템 대시보드는 403 오류를 반환합니다.

대시보드 삭제(delete_dashboard)

• id (문자열, 필수): 삭제할 대시보드 UUID. 읽기 전용 시스템 대시보드는 삭제할 수 없습니다.

대시보드 스냅샷 목록(list_dashboard_snapshots)

• dashboard_id (문자열, 필수): 스냅샷을 나열할 대시보드 UUID.

메타데이터만 반환합니다(id, name, expires_at 등). 고정된 패널 데이터는 get_dashboard_snapshot을 사용하세요.

대시보드 스냅샷 가져오기(get_dashboard_snapshot)

• id (문자열, 필수): 스냅샷 UUID.

dashboard_definition, panel_data, time_range, variables을 포함한 전체 고정 스냅샷을 반환합니다.

대시보드 스냅샷 삭제(delete_dashboard_snapshot)

• id (문자열, 필수): 삭제할 스냅샷 UUID.