MCP 服务器

Last9 Observability MCP

将实时生产环境的上下文信息——日志、指标和追踪——无缝引入到你的本地环境，从而更快地自动修复代码。

README

Last9 MCP 服务器

last9 mcp demo

一个为 Last9 实现的模型上下文协议服务器，它使 AI 代理能够无缝地将实时生产环境上下文（日志、指标和追踪）引入到您的本地环境，从而更快地自动修复代码。

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

状态

可与 Claude 桌面应用程序或 Cursor、Windsurf 和 VSCode (Github Copilot) IDE 配合使用。实现了以下 MCP 工具：

get_exceptions: 获取异常列表。
get_service_graph: 从异常中获取端点的服务图。
get_logs: 获取按服务名称和/或严重级别过滤的日志。
get_drop_rules: 获取日志的丢弃规则，这些规则决定了哪些日志在 Last9 控制平面被过滤掉。
add_drop_rule: 在 Last9 控制平面为日志创建丢弃规则。

工具文档

get_exceptions

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

参数：

limit (integer, optional): 要返回的最大异常数。默认值：20。
start_time_iso (string, optional): ISO 格式的开始时间 (YYYY-MM-DD HH:MM:SS)。
end_time_iso (string, optional): ISO 格式的结束时间 (YYYY-MM-DD HH:MM:SS)。
span_name (string, optional): 要过滤的 span 名称。

get_service_graph

获取给定 span 名称的上游和下游服务，以及每个服务的吞吐量。

参数：

span_name (string, required): 要获取依赖项的 span 名称。
lookback_minutes (integer, optional): 要回溯的分钟数。默认值：60。
start_time_iso (string, optional): ISO 格式的开始时间 (YYYY-MM-DD HH:MM:SS)。

get_logs

获取按可选服务名称和/或严重级别在指定时间范围内过滤的日志。

参数：

service (string, optional): 要获取日志的服务名称。
severity (string, optional): 要获取的日志的严重程度。
start_time_iso (string, optional): ISO 格式的开始时间 (YYYY-MM-DD HH:MM:SS)。
end_time_iso (string, optional): ISO 格式的结束时间 (YYYY-MM-DD HH:MM:SS)。
limit (integer, optional): 要返回的最大日志数。默认值：20。

get_drop_rules

获取日志的丢弃规则，这些规则决定了哪些日志会被过滤掉，无法到达 Last9。

add_drop_rule

添加新的丢弃规则，以过滤掉 Last9 控制平面中的特定日志。

参数：

name (string, required): 丢弃规则的名称。
filters (array, required): 要应用的过滤器条件列表。每个过滤器都有：
- key (string, required): 要过滤的键。仅支持 attributes 和 resource.attributes 键。对于资源属性，使用格式：resource.attributes[key_name]，对于日志属性，使用格式：attributes[key_name]。键名中的双引号必须转义。
- value (string, required): 要过滤的值。
- operator (string, required): 用于过滤的运算符。有效值：
  - "equals"
  - "not_equals"
- conjunction (string, required): 过滤器之间的逻辑连接词。有效值：
  - "and"

安装

您可以使用以下任一方法安装 Last9 Observability MCP 服务器：

Homebrew

# 添加 Last9 tap
brew tap last9/tap

# 安装 Last9 MCP CLI
brew install last9-mcp

NPM

# 全局安装
npm install -g @last9/mcp-server

# 或者直接使用 npx 运行
npx @last9/mcp-server

配置

环境变量

该服务需要以下环境变量：

LAST9_AUTH_TOKEN: Last9 MCP 服务器的身份验证令牌（必需）
LAST9_BASE_URL: Last9 API URL（必需）
LAST9_REFRESH_TOKEN: 具有写入权限的刷新令牌。访问控制平面 API 所需（必需）。
在 Last9 注册并设置其中一个集成。
从此处获取 LAST9_BASE_URL 和 LAST9_AUTH_TOKEN。
可以从 API 访问页面获取写入刷新令牌。

与 Claude Desktop 一起使用

配置 Claude 应用程序以使用 MCP 服务器：

打开 Claude Desktop 应用程序
转到设置，然后是开发者，单击编辑配置
打开 claude_desktop_config.json 文件
将服务器配置复制并粘贴到现有文件中，然后保存
重新启动 Claude

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "last9": {
      "command": "/opt/homebrew/bin/last9-mcp",
      "env": {
        "LAST9_AUTH_TOKEN": "<your_auth_token>",
        "LAST9_BASE_URL": "<last9_otlp_host>",
        "LAST9_REFRESH_TOKEN": "<refresh_token_from_last9_dashboard>"
      }
    }
  }
}

与 Cursor 一起使用

配置 Cursor 以使用 MCP 服务器：

导航到设置，然后是 Cursor 设置
在左侧选择 MCP
单击右上角的添加新的全局 MCP 服务器
将服务器配置复制并粘贴到现有文件中，然后保存
重新启动 Cursor

{
  "mcpServers": {
    "last9": {
      "command": "/opt/homebrew/bin/last9-mcp",
      "env": {
        "LAST9_AUTH_TOKEN": "<auth_token>",
        "LAST9_BASE_URL": "<last9_otlp_host>",
        "LAST9_REFRESH_TOKEN": "<write_refresh_token>"
      }
    }
  }
}

与 Windsurf 一起使用

配置 Windsurf 以使用 MCP 服务器：

打开 Windsurf
转到设置，然后是开发者
单击编辑配置
打开 windsurf_config.json 文件
将服务器配置复制并粘贴到现有文件中，然后保存
重新启动 Windsurf

{
  "mcpServers": {
    "last9": {
      "command": "/opt/homebrew/bin/last9-mcp",
      "env": {
        "LAST9_AUTH_TOKEN": "<auth_token>",
        "LAST9_BASE_URL": "<last9_otlp_host>",
        "LAST9_REFRESH_TOKEN": "<refresh_token>"
      }
    }
  }
}