Last9 MCP Server

这是一个用于Last9的Model Context Protocol服务器实现，它使AI代理能够无缝地将实时生产上下文——日志、指标和跟踪——带入本地环境，从而更快地自动修复代码。

• 查看演示
• 阅读我们的公告博客文章

状态

与Claude桌面应用或Cursor、Windsurf、VSCode（GitHub Copilot）IDE兼容。实现了以下MCP工具：

可观测性和APM工具：

• get_exceptions: 获取异常列表。
• get_service_summary: 获取服务概要，包括吞吐量、错误率和响应时间。
• get_service_environments: 获取服务可用的环境。
• get_service_performance_details: 获取服务的详细性能指标。
• get_service_operations_summary: 获取服务的操作概要。
• get_service_dependency_graph: 获取服务依赖图，显示传入和传出的依赖关系。

Prometheus/PromQL工具：

• prometheus_range_query: 执行PromQL范围查询以获取指标数据。
• prometheus_instant_query: 执行PromQL即时查询以获取指标数据。
• prometheus_label_values: 获取PromQL查询的标签值。
• prometheus_labels: 获取可用于PromQL查询的标签。

日志管理：

• get_logs: 根据服务名称和/或严重级别过滤日志。
• get_drop_rules: 获取日志丢弃规则，确定哪些日志被过滤掉。
• add_drop_rule: 在Last9控制平面创建新的日志丢弃规则。
• get_service_logs: 获取特定服务在指定时间段内的原始日志条目。可以对严重级别和正文进行过滤。
• get_log_attributes: 获取指定时间窗口内可用的日志属性（标签）。

跟踪管理：

• get_traces: 使用JSON管道查询检索跟踪，以进行高级过滤。
• get_service_traces: 根据跟踪ID或服务名称以及时间范围过滤条件检索跟踪。
• get_trace_attributes: 获取指定时间窗口内可用的跟踪属性（系列）。

变更事件：

• get_change_events: 获取来自last9_change_events Prometheus指标的变更事件。

告警管理：

• get_alert_config: 从Last9获取告警配置（告警规则）。
• get_alerts: 从Last9监控系统获取当前活跃的告警。

工具文档

get_exceptions

检索指定时间范围内的服务器端异常。

参数：

• limit (整数，可选)：返回的最大异常数量。默认值：20。
• lookback_minutes (整数，推荐)：从现在开始回溯的分钟数。默认值：60。例如：60, 30, 15。
• start_time_iso (字符串，可选)：ISO格式的开始时间（YYYY-MM-DD HH:MM:SS）。留空则使用lookback_minutes。
• end_time_iso (字符串，可选)：ISO格式的结束时间（YYYY-MM-DD HH:MM:SS）。留空则默认为当前时间。
• service_name (字符串，可选)：根据服务名称过滤异常（如api-service）。
• span_name (字符串，可选)：根据跨度名称过滤。
• deployment_environment (字符串，可选)：根据资源属性中的部署环境过滤异常（如production, staging）。

get_service_summary

获取给定时间范围内的服务概要。包括服务名称、环境、吞吐量、错误率和响应时间。所有值都是该时间范围内的p95分位数。

参数：

• start_time_iso (字符串，可选)：ISO格式的开始时间（YYYY-MM-DD HH:MM:SS）。留空则默认为end_time_iso - 1小时。
• end_time_iso (字符串，可选)：ISO格式的结束时间（YYYY-MM-DD HH:MM:SS）。留空则默认为当前时间。
• env (字符串，可选)：过滤环境。默认值为'prod'。

get_service_environments

获取服务可用的环境。返回一个环境数组，这些环境可以与其他APM工具一起使用。

参数：

• start_time_iso (字符串，可选)：ISO格式的开始时间（YYYY-MM-DD HH:MM:SS）。留空则默认为end_time_iso - 1小时。
• end_time_iso[...继续翻译...]