Last9 MCP Server

一个为 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 (整数，可选): 要返回的最大异常数。 默认值：20。
• start_time_iso (字符串，可选): ISO 格式的开始时间 (YYYY-MM-DD HH:MM:SS)。
• end_time_iso (字符串，可选): ISO 格式的结束时间 (YYYY-MM-DD HH:MM:SS)。
• span_name (字符串，可选): 要过滤的 span 名称。

get_service_graph

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

参数：

• span_name (字符串，必需): 要获取依赖项的 span 名称。
• lookback_minutes (整数，可选): 要回顾的分钟数。 默认值：60。
• start_time_iso (字符串，可选): ISO 格式的开始时间 (YYYY-MM-DD HH:MM:SS)。

get_logs

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

参数：

• service (字符串，可选): 要获取日志的服务名称。
• severity (字符串，可选): 要获取的日志的严重级别。
• start_time_iso (字符串，可选): ISO 格式的开始时间 (YYYY-MM-DD HH:MM:SS)。
• end_time_iso (字符串，可选): ISO 格式的结束时间 (YYYY-MM-DD HH:MM:SS)。
• limit (整数，可选): 要返回的最大日志数。 默认值：20。

get_drop_rules

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

add_drop_rule

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

参数：

• name (字符串，必需): 丢弃规则的名称。
• filters (数组，必需): 要应用的过滤器条件列表。 每个过滤器都有：
  • key (字符串，必需): 要过滤的键。 仅支持 attributes 和 resource.attributes 键。 对于资源属性，使用格式：resource.attributes[key_name]，对于日志属性，使用格式：attributes[key_name]。 键名中的双引号必须转义。
  • value (字符串，必需): 要过滤的值。
  • operator (字符串，必需): 用于过滤的运算符。 有效值：
    • "equals"
    • "not_equals"
  • conjunction (字符串，必需): 过滤器之间的逻辑连接词。 有效值：
    • "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 服务器：

1. 打开 Claude Desktop 应用程序
2. 转到设置，然后转到开发者，单击编辑配置
3. 打开 claude_desktop_config.json 文件
4. 将服务器配置复制并粘贴到现有文件中，然后保存
5. 重新启动 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 服务器：

1. 导航到设置，然后导航到 Cursor 设置
2. 在左侧选择 MCP
3. 单击右上角的添加新的全局 MCP 服务器
4. 将服务器配置复制并粘贴到现有文件中，然后保存
5. 重新启动 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 一起使用

配置 Cursor 以使用 MCP 服务器：

1. 打开 Windsurf
2. 转到设置，然后转到开发者
3. 单击编辑配置
4. 打开 windsurf_config.json 文件
5. 将服务器配置复制并粘贴到现有文件中，然后保存
6. 重新启动 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>"
      }
    }
  }
}