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 處理器以無狀態模式執行，因此任何請求都會獨立處理。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（字串，選用）：省略以取得整個叢集範圍；提供則用於單一服務及其操作關聯。
• 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。視窗不得超過 7 天。
• 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 管線查詢。
• 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

用於廣泛搜尋和彙總。若要精確查詢 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 (陣列，選用)：先前的篩選階段，用於限定數值範圍；省略則取得全域數值。
• lookback_minutes (整數，選用)：預設值：15。
• start_time_iso / end_time_iso (字串，選用)：歷史 RFC3339 時間邊界；優先於 lookback_minutes。
• 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 封裝；waterfall 位於 data 之下。

get_change_events

• start_time_iso / end_time_iso (字串，選用)
• lookback_minutes (整數，選用)：預設值：60。
• service_name (字串，選用)
• env (字串，選用)
• event_name (字串，選用)：先不帶此參數呼叫，以取得 available_event_names。

get_alert_groups

已設定的 Compass 警示群組清單，用於變更看板／標籤覆蓋率稽核。包含零規則的群組以及未觸發的群組。不回傳 PromQL。

• alert_group_name / alert_group_type / data_source_name (字串，選用)：不區分大小寫的子字串比對。
• team / tier (字串，選用)：對已設定中繼資料進行精確且不區分大小寫的比對。
• label_key + label_value (字串，選用)：必須同時設定。對單一 metadata.labels 鍵值對進行精確且不區分大小寫的比對——鍵和值都需相符。

回傳精簡 JSON {"count":N,"groups":[...]}，包含 id、name、type、entity_class、team、tier、metadata.labels 及規則計數。空的 team / labels 表示未設定。

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、電子郵件、webhook 等）。

did_you_mean

• query (字串，必填)：要搜尋的名稱——部分、拼錯或縮寫皆可。
• type (字串，選用)：限制實體類型：service、environment、host、database、k8s_deployment、k8s_namespace、job。

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

get_service_profile

• service_name (字串，必填)：要為其推導遙測設定檔的服務。
• datasource (字串，選用)：資料來源名稱。省略則使用預設值。

回傳簡短的調查摘要，後接完整設定檔的原始 JSON：訊號存在性（logs/traces/metrics 為 present、absent 或 unknown）、語言與執行環境、部署環境、日誌 signal_shape（log_format、severity_set、level_field），以及適用的建議擷取修正。由上游推導並快取，TTL 約 15 分鐘。

在任何服務範圍調查前呼叫此功能，以便工具選擇符合服務的實際遙測——當 traces 為 absent 時跳過 trace 工具；當 severity_set 為 none 或 partial 時，從日誌主體中的 level_field 解析嚴重性，而非使用 severity_filters。metrics 一律為 unknown，且 dependencies 在 v1 中未填入。當 logs 和 traces 皆為 absent 時，先以 did_you_mean 確認名稱，再斷定服務未受監控。

list_dashboards

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

get_dashboard

• id (字串，必填)：儀表板 UUID。
• region (字串，選用)：面板查詢填入的區域。預設為已設定的資料來源區域。

validate_dashboard

唯讀。絕不會建立或更新儀表板。僅接受 dashboard_id 或 dashboard_definition 其中一個。

• dashboard_id (字串，選用)：要驗證的已儲存儀表板 UUID。
• dashboard_definition (物件，選用)：內嵌的未儲存儀表板主體（真正的乾執行）。
• start_time_iso / end_time_iso (字串，選用)：驗證視窗（RFC3339）。必須 ≤ 24 小時。
• region (字串，選用)：面板查詢執行的區域。

回傳 dashboard_validation/v1：逐面板 lint 與執行分類（data / no_data / invalid / error）。第 1 天空結果分類為 valid_no_data，不執行診斷探測。

create_dashboard

僅限全新建立。此呼叫回傳 dashboard.id 後，請以 update_dashboard 進行調整——不要為了新增、刪減或修正面板而再次建立。

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

update_dashboard

建立後優先使用此功能。依 ID 完整取代（主體與建立相同）。

• 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。

get_profile_services

• lookback_minutes / start_time_iso / end_time_iso (選用)：視窗；建議使用回看或明確 ISO 邊界（預設 60 分鐘）。
• region (字串，選用)：區域覆寫。

回傳在視窗內具有剖析資料的服務。在 get_flamegraph / get_top_functions / get_profile_summary 之前呼叫此功能。

get_flamegraph

• service (字串，必填)：來自 get_profile_services 的服務名稱。
• profile_type (字串，選用)：cpu（預設）、alloc 或 wall。比較視窗時請固定類型。
• env / cluster / namespace / runtime (字串，選用)：範圍篩選。
• limit (數字，選用)：最大彙總堆疊列數（預設 1000，最大 10000）。
• lookback_minutes / start_time_iso / end_time_iso / region (選用)。

回傳巢狀火焰圖樹（name / value / self / children）。truncated: true 表示已達 API 列數上限。

get_top_functions

與 get_flamegraph 相同的篩選。回傳最熱門函式的自身取樣排名。可能被截斷；請檢查 truncated。

get_profile_summary

與 get_flamegraph 相同的篩選。回傳該服務剖析的簡短自然語言分流報告。

grafana_search_dashboards

• query (字串，選用)：標題子字串。空白則廣泛列出（受 5,000 列上限約束）。

回傳 {"dashboards":[…], "truncated":bool}，包含 uid、title、uri、url、type、tags。搭配 uid 使用 grafana_get_dashboard。

grafana_get_dashboard

• uid (字串，必填)：Grafana 儀表板 uid。
• full_json (布林值，選用)：為 true 時，回傳原始 Grafana JSON，而非篩選後的摘要。 Default summary: version, tags, templating variables, and each panel's type/datasource/gridPos/promQL targets. Unknown plugin panel types appear in unsupportedPanelTypes.

grafana_list_folders

無參數。回傳資料夾樹狀結構。

grafana_list_folder_dashboards

• folder_uid（字串，必填）：Grafana 資料夾 uid。

回傳該資料夾中儀表板的 {"dashboards":[…], "truncated":bool}（分頁，最多 5,000 筆）。

grafana_list_datasources

無參數。回傳資料來源的安全投影（不含憑證欄位）。