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 リリース からダウンロード後、展開してフルパスを指定します:

{
  "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 (文字列、オプション): スパン名でフィルタリング。
• 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 (文字列、オプション): 環境でフィルタリング。デフォルト: all。
• 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 のいずれか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_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

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

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。読み取り専用のシステムダッシュボードは削除できません。