Last9 MCP 服务器

这是一个为 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。
• 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）。留空则默认为当前时间。
• span_name (字符串, 可选): 要过滤的 span 名称。

get_service_graph

根据给定的 span 名称获取上下游服务及其吞吐量。

参数：

• span_name (字符串, 必需): 获取依赖关系的 span 名称。
• lookback_minutes (整数, 推荐): 从当前时间往回看的分钟数。默认值：60。示例：60, 30, 15。
• start_time_iso (字符串, 可选): 开始时间（ISO 格式 YYYY-MM-DD HH:MM:SS）。留空则使用 lookback_minutes。

get_logs

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

参数：

• service (字符串, 可选): 获取日志的服务名称。
• severity (字符串, 可选): 获取日志的严重性。
• 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）。留空则默认为当前时间。
• limit (整数, 可选): 返回的最大日志数量。默认值：20。

get_drop_rules

获取日志丢弃规则，这些规则决定了哪些日志会被阻止到达 Last9。

add_drop_rule

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

参数：

• name (字符串，必填): 丢弃规则的名称。
• filters (数组，必填): 要应用的过滤条件列表。每个过滤器包含：
  • key (字符串，必填): 过滤依据的键。仅支持属性和资源属性键。对于资源属性，请使用格式：resource.attributes[key_name]；对于日志属性，请使用格式：attributes[key_name]。键名中的双引号必须转义。
  • value (字符串，必填): 用于过滤的值。
  • operator (字符串，必填): 用于过滤的操作符。有效值包括：
    • "equals"
    • "not_equals"
  • conjunction (字符串，必填): 过滤器之间的逻辑连接词。有效值包括：
    • "and"

安装

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

Homebrew

# Add the Last9 tap
brew tap last9/tap

# Install the Last9 MCP CLI
brew install last9-mcp

NPM

# Install globally
npm install -g @last9/mcp-server

# Or run directly with 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 桌面应用程序
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 一起使用

配置 Windsurf 以使用 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>"
      }
    }
  }
}

与 VS Code 一起使用

先决条件：

• VS Code 版本 1.99 或更高版本

配置 VS Code 以使用 MCP 服务器：

1. 在您的工作区中创建 .vscode/mcp.json 文件或在 VS Code 用户设置中添加以下配置：

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

1. 打开聊天视图（macOS 上为 ⌃⌘I，Windows/Linux 上为 Ctrl+Alt+I）
2. 从下拉菜单中选择“代理”模式
3. Last9 MCP 服务器现在将在 VS Code 中可用

注意：请将占位符值（<auth_token>、<last9_otlp_host> 和 <write_refresh_token>）替换为您的实际 Last9 凭据。

有关高级配置选项和替代设置方法，请参阅 官方 VS Code MCP 文档。