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。
• 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（数组，可选）：用于限定值范围的先前过滤阶段；省略则获取全局值。
• 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 信封；瀑布图位于 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, 可选)：跨名称、分组、数据源和标签的自由文本搜索。
• rule_name (string, 可选)
• severity (string, 可选)
• rule_type (string, 可选)：static 或 anomaly。
• alert_group_name / alert_group_type / data_source_name (string, 可选)
• tags (array, 可选)：所有条件都必须匹配（AND 逻辑）。

get_alerts

• time_iso (string, 可选)：RFC3339 格式的评估时间。
• window (integer, 可选)：回看时间（秒）。默认值：900。范围：60–86400。
• lookback_minutes (integer, 可选)：范围：1–1440。

get_alert_rule_state

• start_time (integer, 必填)：范围起始的 Unix 纪元时间（含）。
• end_time (integer, 必填)：范围结束的 Unix 纪元时间（含）。
• step (integer, 必填)：样本之间的分辨率（秒）。((end_time - start_time) / step + 1) 的样本数上限为 100。
• alert_group_id (string, 可选)：按告警组 ID 过滤。
• rule_name (string, 可选)：按规则名称的正则表达式过滤。
• alert_group_name (string, 可选)：按告警组名称的正则表达式过滤。
• label_filters (string, 可选)：逗号分隔的 key=value 标签过滤器。
• state (string, 可选)：按状态过滤（例如 firing）。

返回 rule_id -> [{timestamp, is_firing}] 的 JSON 映射。规则在上游响应中缺失的时间戳会报告为 is_firing=0——这表示“未观察到触发”，而非确认的正常状态。

get_notification_channels

无参数。返回所有已配置的通知渠道（Slack、PagerDuty、电子邮件、Webhook 等）。

did_you_mean

• query (string, 必填)：要搜索的名称——可以是部分、拼写错误或缩写。
• type (string, 可选)：限制实体类型：service、environment、host、database、k8s_deployment、k8s_namespace、job。

返回最多 3 个最接近的匹配项及相似度分数。在实体名称不确定的任何工具调用之前使用此功能。如果之前的调用返回空结果，请在重试前先尝试此功能。

list_dashboards

无参数。返回组织中所有自定义仪表板，以 JSON 数组形式呈现，包含 id、name 和元数据。

get_dashboard

• id (string, 必填)：仪表板 UUID。
• region (string, 可选)：面板查询填充的区域。默认为已配置的数据源区域。

create_dashboard

• dashboard (object, 必填)：包含 name 和 panels[] 的仪表板定义。每个面板需要 name、version、layout（x、y、w、h）、visualization.type 和 queries[]。
• metadata (object, 可选)：仪表板元数据——_category 和 _type 字段（例如 {"_category":"custom","_type":"metrics"}）。

update_dashboard

• id (string, 必填)：要更新的仪表板 UUID。
• dashboard (object, 必填)：完整的替换仪表板主体（与创建时结构相同）。
• metadata (object, 可选)：替换元数据。只读系统仪表板将返回 403 错误。

delete_dashboard

• id (string, 必填)：要删除的仪表板 UUID。只读系统仪表板无法删除。

list_dashboard_snapshots

• dashboard_id (string, 必填)：要列出其快照的仪表板 UUID。

仅返回元数据（id、name、expires_at 等）。如需冻结的面板数据，请使用 get_dashboard_snapshot。

get_dashboard_snapshot

• id (string, 必填)：快照 UUID。

返回完整的冻结快照，包括 dashboard_definition、panel_data、time_range 和 variables。

delete_dashboard_snapshot

• id (string, 必填)：要删除的快照 UUID。