Honeycomb MCP Server 使用说明

项目简介

Honeycomb MCP Server是一个基于 Model Context Protocol (MCP) 的服务器，它允许大型语言模型 (LLM) 客户端直接访问和分析存储在 Honeycomb 中的观测数据。通过资源和工具，LLM 可以查询数据集、分析数据模式、运行分析查询、监控 SLO 和查看 Triggers。

主要功能点

查询多个 Honeycomb 环境的数据集。
分析列和数据模式。
运行分析查询，支持多种计算类型、分组和过滤。
监控 SLO 及其状态。
查看和分析 Triggers。
访问数据集元数据和模式信息。

安装步骤

确保已安装 Node.js 16 或更高版本。
克隆 GitHub 仓库到本地。
在仓库目录下运行 'pnpm install' 安装依赖。
运行 'pnpm run build' 构建项目。

服务器配置 (MCP Client JSON)

{
  "serverName": "honeycomb-mcp-server",
  "command": "node",
  "args": [
    "path/to/your/honeycomb-mcp-server/dist/index.js"
  ],
  "transport": "stdio"
}

注意: 'path/to/your/honeycomb-mcp-server/dist/index.js' 需要替换为实际构建后 'index.js' 文件的路径。

基本使用方法

配置 '.mcp-honeycomb.json' 文件，填入 Honeycomb API keys 和环境信息。
启动 MCP 服务器。由于使用 Stdio 传输，服务器会在终端中运行，等待 MCP 客户端的连接和请求。
在 MCP 客户端（如 Claude）中使用 'honeycomb://{environment}/{dataset}' 格式的 URI 访问 Honeycomb 数据集资源。
使用预定义的工具（如 'list_datasets', 'run_query'）与 Honeycomb 数据进行交互。参考 README 中的 "Example Queries" 部分，向 LLM 客户端发送自然语言指令，例如 "What datasets are available in the production environment?" 或 "Show me the P95 latency for the API service over the last hour"。

关键词