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 handler 以無狀態模式執行，因此任何請求皆獨立處理。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（字串，選用）：依 span 名稱篩選。
• 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（字串，選用）：省略以涵蓋整個 fleet；提供則針對單一服務及其操作關聯。
• 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（浮點數，選用）：查詢時間下限（毫秒）。
• 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 pipeline 查詢。
• 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=... 列出 drop rules。

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

用於廣泛搜尋與彙總。若要精確查詢 trace 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（陣列，選用）：Trace 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（字串，選用）：僅回傳該 span 的屬性、事件與連結。
• max_spans（整數，選用）：預設值：500。上限：1000。

回傳 investigation-evidence/v1 envelope；waterfall 位於 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 (string, optional): 跨名稱、群組、資料來源、標籤進行自由文字搜尋。
• rule_name (string, optional)
• severity (string, optional)
• rule_type (string, optional): static 或 anomaly。
• alert_group_name / alert_group_type / data_source_name (string, optional)
• tags (array, optional): 所有條件都必須符合（AND 邏輯）。

get_alerts

• time_iso (string, optional): RFC3339 格式的評估時間。
• window (integer, optional): 回顧秒數。預設值：900。範圍：60–86400。
• lookback_minutes (integer, optional): 範圍：1–1440。

get_alert_rule_state

• start_time (integer, required): 範圍的 Unix 紀元開始時間（含）。
• end_time (integer, required): 範圍的 Unix 紀元結束時間（含）。
• step (integer, required): 樣本之間的解析度（秒）。樣本數 ((end_time - start_time) / step + 1) 上限為 100。
• alert_group_id (string, optional): 依警示群組 ID 篩選。
• rule_name (string, optional): 對規則名稱進行正則表達式篩選。
• alert_group_name (string, optional): 對警示群組名稱進行正則表達式篩選。
• label_filters (string, optional): 以逗號分隔的 key=value 標籤篩選。
• state (string, optional): 依狀態篩選（例如 firing）。

傳回 rule_id -> [{timestamp, is_firing}] 的 JSON 對應。當規則在上游回應中缺席的時間戳記會回報為 is_firing=0 — 這表示「未觀察到觸發」，而非確認的正常狀態。

get_notification_channels

無參數。傳回所有已設定的通知管道（Slack、PagerDuty、電子郵件、Webhook 等）。

did_you_mean

• query (string, required): 要搜尋的名稱 — 部分、拼錯或縮寫。
• type (string, optional): 限制實體類型：service、environment、host、database、k8s_deployment、k8s_namespace、job。

傳回最多 3 個最接近的相符項目及相似度分數。在實體名稱不確定的任何工具呼叫之前使用此功能。如果先前的呼叫傳回空結果，請在重試前嘗試此功能。

list_dashboards

無參數。傳回組織中所有自訂儀表板，以 JSON 陣列形式，包含 id、name 及中繼資料。

get_dashboard

• id (string, required): 儀表板 UUID。
• region (string, optional): 面板查詢填入的區域。預設為已設定的資料來源區域。

create_dashboard

• dashboard (object, required): 儀表板定義，包含 name 和 panels[]。每個面板需要 name、version、layout（x、y、w、h）、visualization.type 和 queries[]。
• metadata (object, optional): 儀表板中繼資料 — _category 和 _type 欄位（例如 {"_category":"custom","_type":"metrics"}）。

update_dashboard

• id (string, required): 要更新的儀表板 UUID。
• dashboard (object, required): 完整取代的儀表板主體（與 create 相同結構）。
• metadata (object, optional): 取代的中繼資料。唯讀系統儀表板會傳回 403 錯誤。

delete_dashboard

• id (string, required): 要刪除的儀表板 UUID。唯讀系統儀表板無法刪除。

list_dashboard_snapshots

• dashboard_id (string, required): 要列出快照的儀表板 UUID。

僅傳回中繼資料（id、name、expires_at 等）。如需凍結的面板資料，請使用 get_dashboard_snapshot。

get_dashboard_snapshot

• id (string, required): 快照 UUID。

傳回完整的凍結快照，包含 dashboard_definition、panel_data、time_range 和 variables。

delete_dashboard_snapshot

• id (string, required): 要刪除的快照 UUID。