Last9 MCP Server

{
  "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 릴리스에서 다운로드한 후 압축을 풀고 전체 경로를 지정하세요:

{
  "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로 테스트

MCP 스트리밍 가능 HTTP는 먼저 초기화 핸드셰이크가 필요합니다. 첫 번째 요청에 Mcp-Session-Id를 설정하지 마세요.

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

소스에서 빌드

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 (문자열, 선택 사항): 스팬 이름별 필터.
• deployment_environment (문자열, 선택 사항): 환경별 필터.

get_service_summary

• start_time_iso / end_time_iso (문자열, 선택 사항)
• env (문자열, 선택 사항): 기본값은 prod입니다.

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_databases

• env (문자열, 선택): 환경별 필터. 기본값: all.
• 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 (문자열, 필수)
• 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

매개변수 없음.

add_drop_rule

• name (문자열, 필수)
• filters (배열, 필수): 각 필터: key, value, operator (equals/not_equals), conjunction (and).

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_change_events

• start_time_iso / end_time_iso (문자열, 선택)
• lookback_minutes (정수, 선택): 기본값: 60.
• service (문자열, 선택)
• environment (문자열, 선택)
• 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. 읽기 전용 시스템 대시보드는 삭제할 수 없습니다.