使用说明

项目简介

Last9 MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它作为 AI 应用的后端，桥接了 Last9 可观测性平台和支持 MCP 协议的客户端（如 Claude、Cursor、Windsurf、VSCode 等 IDE）。通过 Last9 MCP Server，AI agent 可以便捷地获取实时的生产环境上下文信息，例如应用的异常、服务依赖关系和日志，从而辅助开发者进行更高效的编码、调试和问题排查。

主要功能点

提供生产环境上下文数据: 通过集成的工具，AI agent 可以访问 Last9 平台上的实时日志、异常和服务拓扑数据。
支持多种 MCP 工具: 实现了 'get_exceptions'（获取异常列表）、'get_service_graph'（获取服务拓扑）和 'get_logs' (获取日志) 等工具，方便 AI agent 获取不同类型的可观测性数据。
易于安装和配置: 提供 Homebrew 和 NPM 两种安装方式，方便用户快速部署。
兼容多种 LLM 客户端: 支持 Claude Desktop、Cursor、Windsurf 和 VSCode (Github Copilot) 等多种集成 MCP 客户端的工具。

安装步骤

根据您的环境选择以下安装方式：

1. 使用 Homebrew (macOS 和 Linux):

打开终端并执行以下命令:

brew tap last9/tap
brew install last9-mcp

2. 使用 NPM (跨平台):

确保您已安装 Node.js 和 npm。打开终端并执行以下命令全局安装：

npm install -g @last9/mcp-server

或者，您可以使用 'npx' 直接运行：

npx @last9/mcp-server

服务器配置

Last9 MCP Server 需要以下环境变量进行配置，您需要在启动服务器之前设置这些变量。这些信息需要从 Last9 平台获取 (注册并集成 OpenTelemetry 后在集成页面可以找到):

'LAST9_AUTH_TOKEN': 您的 Last9 认证 Token。
'LAST9_BASE_URL': Last9 API 的基础 URL，通常为 'https://otlp.last9.io'。

MCP 客户端配置 (以 JSON 格式)

对于支持 MCP 的客户端（如 Claude、Cursor、Windsurf），您需要配置 MCP 服务器的连接信息。以下是一个配置示例，您需要将此配置添加到您的 MCP 客户端的配置文件中。

{
  "server name": "last9",
  "command": "/opt/homebrew/bin/last9-mcp",
  "env": {
    "LAST9_AUTH_TOKEN": "YOUR_LAST9_AUTH_TOKEN",
    "LAST9_BASE_URL": "https://otlp.last9.io"
  }
}

配置参数说明:

'"server name"': 为该 MCP 服务器配置指定一个名称，例如 "last9"。
'"command"': MCP 服务器的启动命令。
- 如果您使用 Homebrew 安装，通常为 '"/opt/homebrew/bin/last9-mcp"' (路径可能因系统而异)。
- 如果您使用 NPM 全局安装，可以使用 '"npx @last9/mcp-server"'。
'"env"': 环境变量配置。
- '"LAST9_AUTH_TOKEN"': Last9 认证 Token。 请替换 '"YOUR_LAST9_AUTH_TOKEN"' 为您实际的 Token 值。
- '"LAST9_BASE_URL"': Last9 API 基础 URL。 默认通常为 '"https://otlp.last9.io"'，除非 Last9 平台有特殊说明。

请注意: 根据您的安装方式和系统环境，您可能需要调整 '"command"' 的路径。确保环境变量 '"LAST9_AUTH_TOKEN"' 和 '"LAST9_BASE_URL"' 配置正确，否则 MCP 服务器将无法连接到 Last9 平台。

基本使用方法

启动 Last9 MCP Server: 根据您的安装方式，通过终端命令启动服务器 (例如 'last9-mcp' 或 'npx @last9/mcp-server')。
配置 MCP 客户端: 将上述 JSON 配置添加到您的 MCP 客户端（如 Claude、Cursor 等）的配置文件中，并确保配置参数正确。
在 MCP 客户端中使用: 配置完成后，您的 MCP 客户端即可通过 Last9 MCP Server 提供的工具与 Last9 平台交互。例如，在 IDE 中，您可以指示 AI agent 使用 'get_exceptions' 工具获取异常信息，AI agent 将会调用 Last9 MCP Server，进而从 Last9 平台获取数据并返回给您。

关键词