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 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 测试

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（字符串，可选）：按 Span 名称筛选。
• 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（字符串，可选）：按环境过滤。默认值：全部。
• 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。只读系统仪表板无法删除。