last9/last9-mcp-server

完整文档

{
  "mcpServers": {
    "last9": {
      "type": "http",
      "url": "https://app.last9.io/api/v4/organizations/<org_slug>/mcp"
    }
  }
}

{
  "mcp": {
    "servers": {
      "last9": {
        "type": "http",
        "url": "https://app.last9.io/api/v4/organizations/<org_slug>/mcp"
      }
    }
  }
}

{
  "mcpServers": {
    "last9": {
      "serverUrl": "https://app.last9.io/api/v4/organizations/<org_slug>/mcp"
    }
  }
}

brew install last9/tap/last9-mcp

npm install -g @last9/mcp-server@latest
or directly:

npx -y @last9/mcp-server@latest

{
  "mcpServers": {
    "last9": {
      "command": "/opt/homebrew/bin/last9-mcp",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

{
  "mcpServers": {
    "last9": {
      "command": "npx",
      "args": ["-y", "@last9/mcp-server@latest"],
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

{
  "mcp": {
    "servers": {
      "last9": {
        "type": "stdio",
        "command": "/opt/homebrew/bin/last9-mcp",
        "env": {
          "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "last9": {
      "command": "C:\\Users\\<user>\\AppData\\Local\\Programs\\last9-mcp-server.exe",
      "env": {
        "LAST9_REFRESH_TOKEN": "<your_refresh_token>"
      }
    }
  }
}

使用 curl 测试

Streamable HTTP handler 以无状态模式运行，因此每个请求都是独立处理的。initialize 握手和 Mcp-Session-Id 请求头是可选的 —— 发送这些内容的客户端仍可正常工作（该请求头会被接收并忽略），客户端也可以直接调用 tools/list / tools/call。每个 tool 都是一个独立的请求/响应查询；服务器不发送 server→client 通知，因此 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

</details>

---

Tool Reference

<details>
<summary>所有参数、时间输入标准及详情</summary>

Time Input

• 绝对时间 (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 (integer, 可选): 最大异常数。默认值：20。

• lookback_minutes (integer, 可选): 默认值：60。

• start_time_iso / end_time_iso (string, 可选): 绝对时间范围。

• service_name (string, 可选): 按服务过滤。

• span_name (string, 可选): 按 span 名称过滤。

• env (string, 可选): 按环境过滤。

get_service_summary

• start_time_iso / end_time_iso (string, 可选)

• env (string, 可选): PromQL 正则表达式。默认为 .*。精确匹配需要锚点（例如 ^prod$）。

• sort_by (string, 可选): request_count (默认), throughput_rpm, http_4xx_count, http_5xx_count 或 grpc_error_count。

• limit (integer, 可选): 最大排名行数。省略或为 0 则默认为 10；超过 100 的值将截断为 100。

get_service_environments

• start_time_iso / end_time_iso (string, 可选)> 所有其他 APM 工具都需要 env 值。如果返回为空，请使用 ""。

get_service_performance_details

• service_name (string, required)

• lookback_minutes (integer, optional): 默认值：60。

• start_time_iso / end_time_iso (string, optional)

• env (string, optional): 默认值为 prod。

get_service_operations_summary

• service_name (string, required)

• lookback_minutes (integer, optional): 默认值：60。

• start_time_iso / end_time_iso (string, optional)

• env (string, optional): 默认值为 prod。

get_service_dependency_graph

• service_name (string, optional)

• lookback_minutes (integer, optional): 默认值：60。

• start_time_iso / end_time_iso (string, optional)

• env (string, optional): 默认值为 prod。

get_apm_service_deviations

• service_name (string, optional): fleet 范围则省略；针对单个服务及其操作相关性则提供。

• lookback_minutes (integer, optional): 当前窗口。默认值：60。

• start_time_iso / end_time_iso (string, optional): 明确的当前窗口。

• baseline_start_time_iso / baseline_end_time_iso (string, optional): 明确的基准线。默认值为紧接之前的等时长窗口。

• datasource (string, optional): 将比较限制在单个 datasource。

• env (string, optional): 默认值为 prod。

• max_services / max_operations (integer, optional): 默认 10，每项最大 10。

get_databases- env (string, optional): 按环境过滤。默认值：all。

• lookback_minutes (integer, optional): 默认值：60。

• start_time_iso / end_time_iso (string, optional)

get_database_slow_queries

• db_system (string, optional): 例如 postgresql, mysql, mongodb, redis。

• host (string, optional): 数据库主机 (net_peer_name)。

• service_name (string, optional): 调用服务名称。

• env (string, optional)

• min_duration_ms (float, optional): 最小查询耗时（单位：ms）。

• lookback_minutes (integer, optional): 默认值：60。

• start_time_iso / end_time_iso (string, optional)

• limit (integer, optional): 默认值：20。

get_database_queries

• db_system (string, optional)

• host (string, optional)

• service_name (string, optional)

• env (string, optional)

• lookback_minutes (integer, optional): 默认值：60。

• start_time_iso / end_time_iso (string, optional)

• limit (integer, optional): 默认值：20。

get_database_server_metrics

• db_system (string, required): 例如 postgresql, mysql, mongodb, redis, aerospike。

• host (string, optional)

• lookback_minutes (integer, optional): 默认值：60。

• start_time_iso / end_time_iso (string, optional)

prometheus_range_query

• query (string, required): PromQL 查询语句。

• start_time_iso / end_time_iso (string, optional): 默认为最近 60 分钟。

• lookback_minutes (float, optional): 默认值：60。

prometheus_instant_query- query (string, 必填)

• time_iso (string, 可选)：默认为当前时间。

• lookback_minutes (float, 可选)

prometheus_label_values

• match_query (string, 可选)：PromQL 过滤器。

• label (string, 必填)：Label 名称。

• start_time_iso / end_time_iso (string, 可选)

prometheus_labels

• match_query (string, 可选)：PromQL 过滤器。

• start_time_iso / end_time_iso (string, 可选)

get_logs

• logjson_query (array, 必填)：JSON pipeline 查询。

• lookback_minutes (integer, 可选)：默认值：5。

• start_time_iso / end_time_iso (string, 可选)

• limit (integer, 可选)：服务器默认值：5000。

• index (string, 可选)：physical_index:<name> 或 rehydration_index:<block_name>。

对于基于日志的服务清单，请先查询 physical_index_service_count：

sum by (name, service_name, env) (physical_index_service_count{destination="logs"})

get_service_logs

• service_name (string, required)

• lookback_minutes (integer, optional): 默认值: 60。

• limit (integer, optional): 默认值: 20。

• env (string, optional)

• severity_filters (array, optional): 例如 ["error", "warn"]。采用 OR 逻辑。

• body_filters (array, optional): 例如 ["timeout", "failed"]。采用 OR 逻辑。

• start_time_iso / end_time_iso (string, optional)

• index (string, optional)

多种过滤类型之间采用 AND 组合。每个数组内部采用 OR 逻辑。
请先使用 get_logs 进行广泛的聚合计数；仅在缩小范围至特定 service/env/index 且样本集较小时，才使用 get_service_logs。

get_log_attributes

• lookback_minutes (integer, optional): 默认值: 15。

• start_time_iso / end_time_iso (string, optional)

• region (string, optional)

• index (string, optional)

get_log_attributes_for_pipeline- pipeline (array, required): 用于限定发现范围的前置过滤阶段，例如 [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]。

• lookback_minutes (integer, optional): 默认值：15。

• start_time_iso / end_time_iso (string, optional)

• region (string, optional)

• index (string, optional)

get_drop_rules

无参数。通过 GET /otel_settings/drop?region=... 列出 drop rules。

add_drop_rule

• name (string, required)

• filters (array, required): 每个 filter 包含：key、value、operator (equals/not_equals)、conjunction (and)。

• Filter keys 必须使用 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 (array, required)

• start_time_iso / end_time_iso (string, optional)

• lookback_minutes (integer, optional): 默认值：60。

• limit (integer, optional): 默认值：5000。

get_service_traces

trace_id 或 service_name 必须且只能提供其中一个。

• trace_id (string, optional): 默认回溯时间：72 小时。

• service_name (string, optional): 默认回溯时间：60 分钟。

• lookback_minutes (integer, optional)

• start_time_iso / end_time_iso (string, optional)

• limit (integer, optional): 默认值：10。

• env (string, optional)

get_trace_attributes- lookback_minutes (integer, optional): 默认值：15。

• start_time_iso / end_time_iso (string, optional)

• region (string, optional)

get_trace_attributes_for_pipeline

• pipeline (array, required): 用于限定发现范围的前置过滤阶段，例如 [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}]。

• lookback_minutes (integer, optional): 默认值：15。

• start_time_iso / end_time_iso (string, optional)

• region (string, optional)

get_trace_attribute_values

• tag_name (string, required): 来自 get_trace_attributes 的属性名称（例如 resource_department 或 attributes['http.method']）。

• pipeline (array, optional): 用于限定值范围的前置过滤阶段；若获取全局值则省略。

• region (string, optional)

get_trace_attribute_deviations- comparison_mode (string, 必填): latency、errors 或 time。

• service_name (string, 必填)

• environment (string, 必填): 准确的 deployment.environment 值。

• operation (string, 可选)

• filters (array, 可选): Trace JSON 过滤条件。

• candidate_attributes (array, 可选): 最多 8 个；若为有界发现（bounded discovery）则省略。

• latency_threshold_ms (number, 可选): latency 模式下必填；其他模式下将被拒绝。

• start_time_iso / end_time_iso (string, 可选)

• lookback_minutes (integer, 可选): 默认值：15。最大值：15。

• baseline_start_time_iso / baseline_end_time_iso (string, 可选): time 模式下必填；需与目标窗口不重叠且时长相等。

• minimum_cohort_size (integer, 可选): 默认值：100。最小值：20。

• minimum_value_support (integer, 可选): 默认值：20。最小值：10。

• limit (integer, 可选): 默认值：10。最大值：10。

需要启用配套的 backend 能力。

get_trace_waterfall

• trace_id (string, 必填)

• environment (string, 可选)

• start_time_iso / end_time_iso (string, 可选)

• lookback_minutes (integer, 可选): 默认值：4320 (72 小时)。

• selected_span_id (string, 可选): 仅返回该 span 的 attributes、events 和 links。

• max_spans (integer, 可选): 默认值：500。最大值：1000。

返回一个 investigation-evidence/v1 封包；waterfall 位于 data 字段下。

get_change_events- start_time_iso / end_time_iso (string, 可选)

• lookback_minutes (integer, 可选): 默认值: 60。

• service_name (string, 可选)

• env (string, 可选)

• event_name (string, 可选): 首次调用时请不传此参数以获取 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, required): 时间范围的 Unix epoch 起始时间（包含）。

• end_time (integer, required): 时间范围的 Unix epoch 结束时间（包含）。

• step (integer, required): 样本之间的分辨率（秒）。样本数量 ((end_time - start_time) / step + 1) 上限为 100。

• alert_group_id (string, optional): 按 alert group ID 过滤。

• rule_name (string, optional): 对 rule name 的正则过滤。

• alert_group_name (string, optional): 对 alert group name 的正则过滤。

• label_filters (string, optional): 以逗号分隔的 key=value 标签过滤器。

• state (string, optional): 按 state 过滤（例如 firing）。

返回一个 rule_id -> [{timestamp, is_firing}] 的 JSON 映射。如果在上游响应中缺失某个时间戳，则报告为 is_firing=0 —— 这意味着“未观察到处于 firing 状态”，而非确认的正常状态。

get_notification_channels

无参数。返回所有配置的通知渠道（Slack, PagerDuty, email, webhooks 等）。

did_you_mean

• query (string, required): 要搜索的名称 —— 支持部分匹配、拼写错误或缩写。

• type (string, optional): 限制实体类型：service, environment, host, database, k8s_deployment, k8s_namespace, job。

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

list_dashboards无参数。以 JSON 数组形式返回组织中所有自定义 dashboard 的 id、name 和 metadata。

get_dashboard

• id (string, required): Dashboard UUID。

• region (string, optional): 用于 panel 查询填充的 region。默认为配置的数据源 region。

create_dashboard

• dashboard (object, required): 包含 name 和 panels[] 的 dashboard 定义。每个 panel 需要 name、version、layout (x, y, w, h)、visualization.type 和 queries[]。

• metadata (object, optional): Dashboard 元数据 —— _category 和 _type 字段（例如 {"_category":"custom","_type":"metrics"}）。

update_dashboard

• id (string, required): 要更新的 Dashboard UUID。

• dashboard (object, required): 完整的替换 dashboard 正文（结构与 create 相同）。

• metadata (object, optional): 替换的元数据。只读的系统 dashboard 将返回 403 错误。

delete_dashboard

• id (string, required): 要删除的 Dashboard UUID。只读的系统 dashboard 无法删除。

list_dashboard_snapshots

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

仅返回元数据 (id, name, expires_at 等)。请使用 get_dashboard_snapshot 获取冻结的 panel 数据。

get_dashboard_snapshot

• id (string, required): Snapshot UUID。

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

delete_dashboard_snapshot- id (string, required): 要删除的 Snapshot UUID。

</details>

---

Testing

有关集成测试的设置和说明，请参阅 TESTING.md。

---