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（浮點數，選填）：最小查詢持續時間（毫秒）。
• 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 紀元時間（含）。
• end_time（整數，必填）：範圍結束的 Unix 紀元時間（含）。
• 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 個最接近的匹配項及其相似度分數。在任何實體名稱不確定的工具呼叫前使用此功能。如果先前的呼叫回傳空結果，請在重試前嘗試此功能。

list_dashboards

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

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。唯讀的系統儀表板無法刪除。