关键词

可观测性平台日志分析指标查询追踪数据LLM功能扩展

项目简介

Chronosphere MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器端应用。它旨在将 Chronosphere 可观测性平台中的丰富数据和操作能力，以标准化的工具形式提供给大型语言模型（LLM）客户端。通过此服务器，LLM 可以调用工具来查询日志、指标、追踪、事件，以及管理配置实体，从而实现更智能、上下文感知的交互。

主要功能点

  • 数据查询工具: 提供查询 Chronosphere 平台中日志、指标、追踪和事件数据的工具，例如获取日志直方图、查询 Prometheus 指标、列出追踪信息。
  • 配置管理工具: 允许 LLM 访问和管理 Chronosphere 的配置实体，例如获取或列出 Dashboard、Drop Rule、Monitor 等。
  • LLM 集成支持: 通过标准化的 MCP 协议，与各种 LLM 客户端无缝集成，提供上下文信息和功能调用接口。
  • 多传输协议支持: 支持多种传输协议，确保 LLM 客户端可以灵活地连接。

安装步骤

  1. 克隆仓库: 首先，将 'chronosphere-mcp' 仓库克隆到您的本地机器上。 
    git clone https://github.com/chronosphereio/chronosphere-mcp.git
cd chronosphere-mcp
  2. 构建二进制文件: 进入仓库目录，运行 'make chronomcp' 命令来编译服务器程序。这将生成名为 'chronomcp' 的可执行文件，通常位于 'bin/chronomcp'。 
    make chronomcp
  3. 配置 API 令牌: 默认情况下，构建系统预期 Chronosphere API 令牌存储在 '.chronosphere_api_token' 文件中。您也可以在运行服务器时通过环境变量 'CHRONOSPHERE_API_TOKEN' 提供。确保您拥有有效的 Chronosphere 组织名称和 API 令牌。
  4. 运行 MCP 服务器:
    • 使用默认配置运行： 
      make run-chronomcp CHRONOSPHERE_ORG_NAME=<您的组织名称> CHRONOSPHERE_API_TOKEN=<您的API令牌>
    • 若需使用 HTTP 流传输（例如用于调试）： 
      make run-chronomcp CONFIG_FILE=./config.http.yaml CHRONOSPHERE_ORG_NAME=<您的组织名称> CHRONOSPHERE_API_TOKEN=<您的API令牌>

服务器配置 (MCP 客户端配置)

MCP 服务器是为 MCP 客户端提供服务的。以下是 MCP 客户端需要配置的信息示例（JSON 格式），以便连接并使用 Chronosphere MCP 服务器：

{
    "mcpServers": {
        "chronosphere-mcp": {
            // 启动 Chronosphere MCP 服务器二进制文件的完整路径
            "command": "<PATH/TO/REPO>/bin/chronomcp",
            // 传递给服务器的参数，-c 指定配置文件路径
            "args": [
                "-c",
                "<PATH/TO/REPO>/config.yaml"
            ],
            // 服务器运行所需的环境变量
            "env": {
                "CHRONOSPHERE_ORG_NAME": "<您的Chronosphere组织名称>",
                "CHRONOSPHERE_API_TOKEN": "<您的API令牌>"
            }
        }
    }
}

基本使用方法 (LLM 客户端调用)

一旦 Chronosphere MCP 服务器运行起来，LLM 客户端（如 Claude Desktop 或 Cursor）就可以通过 JSON-RPC 协议连接到它。

LLM 客户端将能够发现服务器提供的各种工具（如 'metrics/query_prometheus_range', 'logs/list_logs' 等）。例如，客户端可以向服务器发送请求，调用 'metrics/query_prometheus_range' 工具来查询 Prometheus 指标数据，或者调用 'logs/list_logs' 来获取日志信息。服务器将根据请求执行相应的操作，并将结果以 JSON-RPC 响应的形式返回给 LLM 客户端。

开发者可以通过 '@modelcontextprotocol/inspector' 工具来调试 MCP 工具。启动 MCP 服务器后，运行 'npx @modelcontextprotocol/inspector node build/index.js'，然后打开浏览器访问 'http://localhost:6274/#resources'，并配置 URL 为 'http://0.0.0.0:8081/mcp'，传输类型选择 Streamable HTTP 进行调试。

信息

分类

AI与计算

访问项目