Last9 MCP Server

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

Với NPM: sử dụng "command": "npx" và thêm "args": ["-y", "@last9/mcp-server@latest"].

Sau khi tải về từ GitHub Releases, giải nén và trỏ đến đường dẫn đầy đủ:

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

Sử dụng NPM dễ dàng hơn trên Windows — không cần quản lý đường dẫn.

Chạy ở chế độ HTTP

export LAST9_REFRESH_TOKEN="your_refresh_token"
export LAST9_HTTP=true
export LAST9_PORT=8080
./last9-mcp-server

Máy chủ khởi động tại http://localhost:8080/mcp.

Kiểm tra với curl

MCP Streamable HTTP yêu cầu bắt tay khởi tạo trước. Đừng đặt Mcp-Session-Id trong yêu cầu đầu tiên.

# 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
        }
      }
    }'

Xây dựng từ mã nguồn

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 dành cho phát triển cục bộ. Để sử dụng thực tế, điểm cuối HTTP được lưu trữ dễ dàng hơn.

Đầu vào thời gian

• Thời gian tuyệt đối (start_time_iso/end_time_iso, hoặc time_iso) được ưu tiên hơn lookback_minutes.
• Đối với cửa sổ tương đối: sử dụng lookback_minutes.
• Đối với cửa sổ tuyệt đối: sử dụng RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• YYYY-MM-DD HH:MM:SS cũ chỉ được chấp nhận để tương thích.

get_exceptions

• limit (số nguyên, tùy chọn): Ngoại lệ tối đa. Mặc định: 20.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn): Phạm vi thời gian tuyệt đối.
• service_name (chuỗi, tùy chọn): Lọc theo dịch vụ.
• span_name (chuỗi, tùy chọn): Lọc theo tên span.
• deployment_environment (chuỗi, tùy chọn): Lọc theo môi trường.

get_service_summary

• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Mặc định là prod.

get_service_environments

• start_time_iso / end_time_iso (chuỗi, tùy chọn)

Tất cả các công cụ APM khác yêu cầu giá trị env. Sử dụng "" nếu công cụ này trả về trống.

get_service_performance_details

• service_name (chuỗi, bắt buộc)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Mặc định là prod.

get_service_operations_summary

• service_name (chuỗi, bắt buộc)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Mặc định là prod.

get_service_dependency_graph

• service_name (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn): Mặc định là prod.

get_databases

• env (chuỗi, tùy chọn): Lọc theo môi trường. Mặc định: tất cả.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

get_database_slow_queries

• db_system (chuỗi, tùy chọn): ví dụ: postgresql, mysql, mongodb, redis.
• host (chuỗi, tùy chọn): Máy chủ cơ sở dữ liệu (net_peer_name).
• service_name (chuỗi, tùy chọn): Tên dịch vụ gọi.
• env (chuỗi, tùy chọn)
• min_duration_ms (số thực, tùy chọn): Thời lượng truy vấn tối thiểu tính bằng ms.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định: 20.

get_database_queries

• db_system (chuỗi, tùy chọn)
• host (chuỗi, tùy chọn)
• service_name (chuỗi, tùy chọn)
• env (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định: 20.

get_database_server_metrics

• db_system (chuỗi, bắt buộc): ví dụ: postgresql, mysql, mongodb, redis, aerospike.
• host (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

prometheus_range_query

• query (chuỗi, bắt buộc): Truy vấn PromQL.
• start_time_iso / end_time_iso (chuỗi, tùy chọn): Mặc định là 60 phút trước.
• lookback_minutes (số thực, tùy chọn): Mặc định: 60.

prometheus_instant_query

• query (chuỗi, bắt buộc)
• time_iso (chuỗi, tùy chọn): Mặc định là hiện tại.
• lookback_minutes (số thực, tùy chọn)

prometheus_label_values

• match_query (chuỗi, tùy chọn): Bộ lọc PromQL.
• label (chuỗi, bắt buộc): Tên nhãn.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

prometheus_labels

• match_query (chuỗi, tùy chọn): Bộ lọc PromQL.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)

get_logs

• logjson_query (mảng, bắt buộc): Truy vấn pipeline JSON.
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 5.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định máy chủ: 5000.
• index (chuỗi, tùy chọn): physical_index:<name> hoặc rehydration_index:<block_name>.

Đối với kho dịch vụ dựa trên log, truy vấn physical_index_service_count trước:

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

Sử dụng service_name làm ServiceName, env làm môi trường khi có, và name làm tên chỉ mục vật lý. Nếu name="default", bỏ qua index; đối với chỉ mục vật lý không mặc định do người dùng chọn, truyền index: "physical_index:<name>". Nếu backend từ chối lọc chỉ mục vật lý tường minh, thử lại mà không có index và báo cáo rằng lọc chỉ mục vật lý tường minh không khả dụng cho backend đó.

get_service_logs

• service (chuỗi, bắt buộc)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• limit (số nguyên, tùy chọn): Mặc định: 20.
• env (chuỗi, tùy chọn)
• severity_filters (mảng, tùy chọn): ví dụ: ["error", "warn"]. Logic OR.
• body_filters (mảng, tùy chọn): ví dụ: ["timeout", "failed"]. Logic OR.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• index (chuỗi, tùy chọn)

Nhiều loại bộ lọc kết hợp với AND. Mỗi mảng sử dụng OR nội bộ. Sử dụng get_logs cho số lượng tổng hợp rộng trước; chỉ sử dụng get_service_logs sau khi thu hẹp vào một dịch vụ/môi trường/chỉ mục và một tập mẫu nhỏ.

get_log_attributes

• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)
• index (chuỗi, tùy chọn)

get_log_attributes_for_pipeline

• pipeline (mảng, bắt buộc): Các giai đoạn lọc trước để giới hạn phạm vi khám phá, ví dụ: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)
• index (chuỗi, tùy chọn)

get_drop_rules

Không có tham số.

add_drop_rule

• name (chuỗi, bắt buộc)
• filters (mảng, bắt buộc): Mỗi bộ lọc: key, value, operator (equals/not_equals), conjunction (and).

get_traces

Sử dụng cho tìm kiếm và tổng hợp rộng. Để tra cứu chính xác ID trace, sử dụng get_service_traces.

• tracejson_query (mảng, bắt buộc)
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• limit (số nguyên, tùy chọn): Mặc định: 5000.

get_service_traces

Yêu cầu chính xác một trong trace_id hoặc service_name.

• trace_id (chuỗi, tùy chọn): Khoảng thời gian tra cứu mặc định: 72 giờ.
• service_name (chuỗi, tùy chọn): Khoảng thời gian tra cứu mặc định: 60 phút.
• lookback_minutes (số nguyên, tùy chọn)
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• limit (số nguyên, tùy chọn): Mặc định: 10.
• env (chuỗi, tùy chọn)

get_trace_attributes

• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)

get_trace_attributes_for_pipeline

• pipeline (mảng, bắt buộc): Các giai đoạn lọc trước để giới hạn phạm vi khám phá, ví dụ: [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 15.
• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• region (chuỗi, tùy chọn)

get_trace_attribute_values

• tag_name (chuỗi, bắt buộc): Tên thuộc tính từ get_trace_attributes (ví dụ: resource_department hoặc attributes['http.method']).
• pipeline (mảng, tùy chọn): Các giai đoạn lọc trước để giới hạn phạm vi giá trị; bỏ qua để lấy giá trị toàn cục.
• region (chuỗi, tùy chọn)

get_change_events

• start_time_iso / end_time_iso (chuỗi, tùy chọn)
• lookback_minutes (số nguyên, tùy chọn): Mặc định: 60.
• service (chuỗi, tùy chọn)
• environment (chuỗi, tùy chọn)
• event_name (chuỗi, tùy chọn): Gọi không có tham số này trước để lấy available_event_names.

get_alert_config

• search_term (chuỗi, tùy chọn): Tìm kiếm văn bản tự do trên tên, nhóm, nguồn dữ liệu, thẻ.
• rule_name (chuỗi, tùy chọn)
• severity (chuỗi, tùy chọn)
• rule_type (chuỗi, tùy chọn): static hoặc anomaly.
• alert_group_name / alert_group_type / data_source_name (chuỗi, tùy chọn)
• tags (mảng, tùy chọn): Tất cả phải khớp (logic AND).

get_alerts

• time_iso (chuỗi, tùy chọn): Thời gian đánh giá theo RFC3339.
• window (số nguyên, tùy chọn): Khoảng thời gian tra cứu tính bằng giây. Mặc định: 900. Phạm vi: 60–86400.
• lookback_minutes (số nguyên, tùy chọn): Phạm vi: 1–1440.

get_alert_rule_state

• start_time (số nguyên, bắt buộc): Điểm bắt đầu phạm vi theo Unix epoch (bao gồm).
• end_time (số nguyên, bắt buộc): Điểm kết thúc phạm vi theo Unix epoch (bao gồm).
• step (số nguyên, bắt buộc): Độ phân giải tính bằng giây giữa các mẫu. Số lượng mẫu ((end_time - start_time) / step + 1) được giới hạn ở 100.
• alert_group_id (chuỗi, tùy chọn): Lọc theo ID nhóm cảnh báo.
• rule_name (chuỗi, tùy chọn): Bộ lọc regex trên tên quy tắc.
• alert_group_name (chuỗi, tùy chọn): Bộ lọc regex trên tên nhóm cảnh báo.
• label_filters (chuỗi, tùy chọn): Các bộ lọc nhãn key=value phân tách bằng dấu phẩy.
• state (chuỗi, tùy chọn): Lọc theo trạng thái (ví dụ: firing).

Trả về một bản đồ JSON của rule_id -> [{timestamp, is_firing}]. Một dấu thời gian mà tại đó một quy tắc vắng mặt trong phản hồi upstream được báo cáo là is_firing=0 — điều này có nghĩa là "không được quan sát thấy đang kích hoạt", không phải là trạng thái bình thường đã xác nhận.

get_notification_channels

Không có tham số. Trả về tất cả các kênh thông báo đã cấu hình (Slack, PagerDuty, email, webhooks, v.v.).

did_you_mean

• query (chuỗi, bắt buộc): Tên cần tìm kiếm — một phần, sai chính tả hoặc viết tắt.
• type (chuỗi, tùy chọn): Giới hạn theo loại thực thể: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Trả về tối đa 3 kết quả khớp gần nhất với điểm tương đồng. Sử dụng điều này trước bất kỳ lệnh gọi công cụ nào khi tên thực thể không chắc chắn. Nếu lệnh gọi trước đó trả về kết quả trống, hãy thử điều này trước khi thử lại.

list_dashboards

Không có tham số. Trả về tất cả các bảng điều khiển tùy chỉnh trong tổ chức dưới dạng mảng JSON với id, name và siêu dữ liệu.

get_dashboard

• id (chuỗi, bắt buộc): UUID bảng điều khiển.
• region (chuỗi, tùy chọn): Khu vực để điền truy vấn bảng điều khiển. Mặc định là khu vực nguồn dữ liệu đã cấu hình.

create_dashboard

• dashboard (đối tượng, bắt buộc): Định nghĩa bảng điều khiển với name và panels[]. Mỗi bảng điều khiển yêu cầu name, version, layout (x, y, w, h), visualization.type và queries[].
• metadata (đối tượng, tùy chọn): Siêu dữ liệu bảng điều khiển — các trường _category và _type (ví dụ: {"_category":"custom","_type":"metrics"}).

update_dashboard

• id (chuỗi, bắt buộc): UUID bảng điều khiển cần cập nhật.
• dashboard (đối tượng, bắt buộc): Nội dung bảng điều khiển thay thế đầy đủ (cùng hình dạng như tạo mới).
• metadata (đối tượng, tùy chọn): Siêu dữ liệu thay thế. Bảng điều khiển hệ thống chỉ đọc sẽ trả về lỗi 403.

delete_dashboard

• id (chuỗi, bắt buộc): UUID bảng điều khiển cần xóa. Không thể xóa bảng điều khiển hệ thống chỉ đọc.