Last9 MCP Server

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

Untuk NPM: gunakan "command": "npx" dan tambahkan "args": ["-y", "@last9/mcp-server@latest"].

Setelah mengunduh dari GitHub Releases, ekstrak dan arahkan ke path lengkap:

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

Rute NPM lebih mudah di Windows — tidak ada manajemen path.

Jalankan dalam Mode HTTP

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

Server dimulai di http://localhost:8080/mcp.

Uji dengan curl

MCP Streamable HTTP memerlukan jabat tangan inisialisasi terlebih dahulu. Jangan atur Mcp-Session-Id pada permintaan pertama.

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

Bangun dari Sumber

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 untuk pengembangan lokal. Untuk penggunaan sebenarnya, endpoint HTTP hosted lebih mudah.

Input Waktu

• Waktu absolut (start_time_iso/end_time_iso, atau time_iso) diutamakan daripada lookback_minutes.
• Untuk jendela relatif: gunakan lookback_minutes.
• Untuk jendela absolut: gunakan RFC3339/ISO8601 — 2026-02-09T15:04:05Z.
• YYYY-MM-DD HH:MM:SS lawas diterima hanya untuk kompatibilitas.

get_exceptions

• limit (integer, opsional): Maks exception. Default: 20.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional): Rentang waktu absolut.
• service_name (string, opsional): Filter berdasarkan layanan.
• span_name (string, opsional): Filter berdasarkan nama span.
• deployment_environment (string, opsional): Filter berdasarkan lingkungan.

get_service_summary

• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default ke prod.

get_service_environments

• start_time_iso / end_time_iso (string, opsional)

Semua alat APM lainnya memerlukan nilai env. Gunakan "" jika ini mengembalikan kosong.

get_service_performance_details

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default ke prod.

get_service_operations_summary

• service_name (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default ke prod.

get_service_dependency_graph

• service_name (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• env (string, opsional): Default ke prod.

get_databases

• env (string, opsional): Filter berdasarkan environment. Default: all.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)

get_database_slow_queries

• db_system (string, opsional): mis. postgresql, mysql, mongodb, redis.
• host (string, opsional): Host database (net_peer_name).
• service_name (string, opsional): Nama layanan pemanggil.
• env (string, opsional)
• min_duration_ms (float, opsional): Durasi kueri minimum dalam ms.
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 20.

get_database_queries

• db_system (string, opsional)
• host (string, opsional)
• service_name (string, opsional)
• env (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 20.

get_database_server_metrics

• db_system (string, wajib): mis. postgresql, mysql, mongodb, redis, aerospike.
• host (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• start_time_iso / end_time_iso (string, opsional)

prometheus_range_query

• query (string, wajib): Kueri PromQL.
• start_time_iso / end_time_iso (string, opsional): Default ke 60 menit terakhir.
• lookback_minutes (float, opsional): Default: 60.

prometheus_instant_query

• query (string, wajib)
• time_iso (string, opsional): Default ke sekarang.
• lookback_minutes (float, opsional)

prometheus_label_values

• match_query (string, opsional): Filter PromQL.
• label (string, wajib): Nama label.
• start_time_iso / end_time_iso (string, opsional)

prometheus_labels

• match_query (string, opsional): Filter PromQL.
• start_time_iso / end_time_iso (string, opsional)

get_logs

• logjson_query (array, wajib): Kueri pipeline JSON.
• lookback_minutes (integer, opsional): Default: 5.
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default server: 5000.
• index (string, opsional): physical_index:<name> atau rehydration_index:<block_name>.

Untuk inventaris layanan berbasis log, kueri physical_index_service_count terlebih dahulu:

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

Gunakan service_name sebagai ServiceName, env sebagai environment jika ada, dan name sebagai nama indeks fisik. Jika name="default", hilangkan index; untuk indeks fisik non-default yang dipilih pengguna, berikan index: "physical_index:<name>". Jika backend menolak pemfilteran indeks fisik eksplisit, coba lagi tanpa index dan laporkan bahwa pemfilteran indeks fisik eksplisit tidak tersedia untuk backend tersebut.

get_service_logs

• service (string, wajib)
• lookback_minutes (integer, opsional): Default: 60.
• limit (integer, opsional): Default: 20.
• env (string, opsional)
• severity_filters (array, opsional): mis. ["error", "warn"]. Logika OR.
• body_filters (array, opsional): mis. ["timeout", "failed"]. Logika OR.
• start_time_iso / end_time_iso (string, opsional)
• index (string, opsional)

Beberapa tipe filter digabungkan dengan AND. Setiap array menggunakan OR secara internal. Gunakan get_logs untuk hitungan agregat luas terlebih dahulu; gunakan get_service_logs hanya setelah mempersempit ke layanan/env/indeks dan set sampel kecil.

get_log_attributes

• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)
• index (string, opsional)

get_log_attributes_for_pipeline

• pipeline (array, wajib): Tahapan filter sebelumnya untuk membatasi cakupan penemuan, mis. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)
• index (string, opsional)

get_drop_rules

Tidak ada parameter.

add_drop_rule

• name (string, wajib)
• filters (array, wajib): Setiap filter: key, value, operator (equals/not_equals), conjunction (and).

get_traces

Gunakan untuk pencarian luas dan agregasi. Untuk pencarian trace ID yang tepat, gunakan get_service_traces.

• tracejson_query (array, wajib)
• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• limit (integer, opsional): Default: 5000.

get_service_traces

Tepat salah satu dari trace_id atau service_name wajib diisi.

• trace_id (string, opsional): Lookback default: 72 jam.
• service_name (string, opsional): Lookback default: 60 menit.
• lookback_minutes (integer, opsional)
• start_time_iso / end_time_iso (string, opsional)
• limit (integer, opsional): Default: 10.
• env (string, opsional)

get_trace_attributes

• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)

get_trace_attributes_for_pipeline

• pipeline (array, wajib): Tahapan filter sebelumnya untuk membatasi cakupan penemuan, mis. [{"type":"filter","query":{"$eq":["ServiceName","<service>"]}}].
• lookback_minutes (integer, opsional): Default: 15.
• start_time_iso / end_time_iso (string, opsional)
• region (string, opsional)

get_trace_attribute_values

• tag_name (string, wajib): Nama atribut dari get_trace_attributes (mis. resource_department atau attributes['http.method']).
• pipeline (array, opsional): Tahapan filter sebelumnya untuk membatasi nilai; hilangkan untuk nilai global.
• region (string, opsional)

get_change_events

• start_time_iso / end_time_iso (string, opsional)
• lookback_minutes (integer, opsional): Default: 60.
• service (string, opsional)
• environment (string, opsional)
• event_name (string, opsional): Panggil tanpa ini terlebih dahulu untuk mendapatkan available_event_names.

get_alert_config

• search_term (string, opsional): Pencarian teks bebas di seluruh nama, grup, sumber data, tag.
• rule_name (string, opsional)
• severity (string, opsional)
• rule_type (string, opsional): static atau anomaly.
• alert_group_name / alert_group_type / data_source_name (string, opsional)
• tags (array, opsional): Semua harus cocok (logika AND).

get_alerts

• time_iso (string, opsional): Waktu evaluasi dalam RFC3339.
• window (integer, opsional): Lookback dalam detik. Default: 900. Rentang: 60–86400.
• lookback_minutes (integer, opsional): Rentang: 1–1440.

get_alert_rule_state

• start_time (integer, wajib): Awal rentang epoch Unix (inklusif).
• end_time (integer, wajib): Akhir rentang epoch Unix (inklusif).
• step (integer, wajib): Resolusi dalam detik antar sampel. Jumlah sampel ((end_time - start_time) / step + 1) dibatasi hingga 100.
• alert_group_id (string, opsional): Filter berdasarkan ID grup alert.
• rule_name (string, opsional): Filter regex pada nama aturan.
• alert_group_name (string, opsional): Filter regex pada nama grup alert.
• label_filters (string, opsional): Filter label key=value yang dipisahkan koma.
• state (string, opsional): Filter berdasarkan state (mis. firing).

Mengembalikan peta JSON dari rule_id -> [{timestamp, is_firing}]. Timestamp di mana suatu aturan tidak ada dalam respons upstream dilaporkan sebagai is_firing=0 — ini berarti "tidak teramati sebagai firing", bukan status normal yang terkonfirmasi.

get_notification_channels

Tidak ada parameter. Mengembalikan semua saluran notifikasi yang dikonfigurasi (Slack, PagerDuty, email, webhook, dll.).

did_you_mean

• query (string, wajib): Nama yang akan dicari — sebagian, salah eja, atau disingkat.
• type (string, opsional): Batasi ke tipe entitas: service, environment, host, database, k8s_deployment, k8s_namespace, job.

Mengembalikan hingga 3 kecocokan terdekat dengan skor kemiripan. Gunakan ini sebelum pemanggilan alat apa pun yang nama entitasnya tidak pasti. Jika panggilan sebelumnya mengembalikan hasil kosong, coba ini sebelum mencoba lagi.

list_dashboards

Tidak ada parameter. Mengembalikan semua dasbor kustom di organisasi sebagai array JSON dengan id, name, dan metadata.

get_dashboard

• id (string, wajib): UUID Dasbor.
• region (string, opsional): Region untuk populasi kueri panel. Default ke region sumber data yang dikonfigurasi.

create_dashboard

• dashboard (object, wajib): Definisi dasbor dengan name dan panels[]. Setiap panel memerlukan name, version, layout (x, y, w, h), visualization.type, dan queries[].
• metadata (object, opsional): Metadata dasbor — field _category dan _type (mis. {"_category":"custom","_type":"metrics"}).

update_dashboard

• id (string, wajib): UUID dasbor yang akan diperbarui.
• dashboard (object, wajib): Body dasbor pengganti penuh (bentuk sama seperti create).
• metadata (object, opsional): Metadata pengganti. Dasbor sistem readonly akan mengembalikan error 403.

delete_dashboard

• id (string, wajib): UUID dasbor yang akan dihapus. Dasbor sistem readonly tidak dapat dihapus.