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（文字列、オプション）: スパン名でフィルタリング。
• 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（文字列、オプション）: フリート全体のスコープでは省略。1 つのサービスとそのオペレーション相関を指定する場合は指定します。
• lookback_minutes（整数、オプション）: 現在のウィンドウ。デフォルト: 60。
• start_time_iso / end_time_iso（文字列、オプション）: 明示的な現在のウィンドウ。
• baseline_start_time_iso / baseline_end_time_iso（文字列、オプション）: 明示的なベースライン。デフォルトは直前の同一時間幅のウィンドウ。
• datasource（文字列、オプション）: 比較を 1 つのデータソースに制限します。
• 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（浮動小数点数、オプション）: 最小クエリ時間（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

広範な検索と集計に使用します。正確なトレース ID の検索には get_service_traces を使用します。

• tracejson_query（配列、必須）
• start_time_iso / end_time_iso（文字列、オプション）
• lookback_minutes（整数、オプション）: デフォルト: 60。
• limit（整数、オプション）: デフォルト: 5000。

get_service_traces

trace_id または service_name のいずれか 1 つが必須です。

• 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（配列、オプション）: トレース 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（文字列、オプション）: そのスパンのみの属性、イベント、リンクを返します。
• 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, optional): 名前、グループ、データソース、タグを横断するフリーテキスト検索。
• rule_name (string, optional)
• severity (string, optional)
• rule_type (string, optional): static または anomaly。
• alert_group_name / alert_group_type / data_source_name (string, optional)
• tags (array, optional): すべて一致する必要があります（AND ロジック）。

get_alerts

• time_iso (string, optional): RFC3339 形式の評価時刻。
• window (integer, optional): ルックバック秒数。デフォルト: 900。範囲: 60–86400。
• lookback_minutes (integer, optional): 範囲: 1–1440。

get_alert_rule_state

• start_time (integer, required): 範囲の開始時刻の Unix エポック（含む）。
• end_time (integer, required): 範囲の終了時刻の Unix エポック（含む）。
• step (integer, required): サンプル間の解像度（秒）。サンプル数 ((end_time - start_time) / step + 1) は最大 100 件に制限されています。
• alert_group_id (string, optional): アラートグループ ID でフィルタリングします。
• rule_name (string, optional): ルール名に対する正規表現フィルタ。
• alert_group_name (string, optional): アラートグループ名に対する正規表現フィルタ。
• label_filters (string, optional): カンマ区切りの key=value ラベルフィルタ。
• state (string, optional): 状態でフィルタリング（例: firing）。

rule_id -> [{timestamp, is_firing}] の JSON マップを返します。ルールがアップストリームのレスポンスに存在しないタイムスタンプは is_firing=0 として報告されます。これは「発火中として観測されていない」という意味であり、正常状態が確認されたわけではありません。

get_notification_channels

パラメータはありません。設定済みのすべての通知チャネル（Slack、PagerDuty、メール、Webhook など）を返します。

did_you_mean

• query (string, required): 検索する名前 — 部分一致、スペルミス、省略形に対応。
• type (string, optional): エンティティタイプに制限: service、environment、host、database、k8s_deployment、k8s_namespace、job。

類似度スコア付きで最も近い一致を最大 3 件返します。エンティティ名が不明確な場合は、任意のツール呼び出しの前にこれを使用してください。以前の呼び出しが空の結果を返した場合は、再試行する前にこれを試してください。

list_dashboards

パラメータはありません。組織内のすべてのカスタムダッシュボードを、id、name、メタデータを含む JSON 配列として返します。

get_dashboard

• id (string, required): ダッシュボード UUID。
• region (string, optional): パネルクエリ生成のリージョン。デフォルトは設定済みのデータソースリージョン。

create_dashboard

• dashboard (object, required): name と panels[] を含むダッシュボード定義。各パネルには name、version、layout（x、y、w、h）、visualization.type、queries[] が必要です。
• metadata (object, optional): ダッシュボードのメタデータ — _category と _type フィールド（例: {"_category":"custom","_type":"metrics"}）。

update_dashboard

• id (string, required): 更新するダッシュボード UUID。
• dashboard (object, required): 完全な置き換え用ダッシュボード本文（create と同じ形式）。
• metadata (object, optional): 置き換え用メタデータ。読み取り専用のシステムダッシュボードは 403 エラーを返します。

delete_dashboard

• id (string, required): 削除するダッシュボード UUID。読み取り専用のシステムダッシュボードは削除できません。

list_dashboard_snapshots

• dashboard_id (string, required): スナップショットを一覧表示するダッシュボード UUID。

メタデータのみを返します（id、name、expires_at など）。凍結されたパネルデータには get_dashboard_snapshot を使用してください。

get_dashboard_snapshot

• id (string, required): スナップショット UUID。

dashboard_definition、panel_data、time_range、variables を含む完全な凍結スナップショットを返します。

delete_dashboard_snapshot

• id (string, required): 削除するスナップショット UUID。