MCP 遥测

<div align="center">

一个模型上下文协议 (MCP) 服务器，用于在使用 Weights & Biases Weave 的聊天系统中进行遥测

</div>

概述

MCP 遥测提供了一个简单的接口，用于记录和跟踪用户与 LLM 之间的对话。它利用 模型上下文协议 来公开遥测工具，这些工具可用于跟踪和分析对话。

特性

• 使用自定义标识符启动跟踪会话
• 记录全面的对话数据，包括：
  • 用户输入
  • LLM 响应
  • LLM 操作
  • 工具调用及其结果
• 与 Weights & Biases Weave 无缝集成，用于可视化和分析
• 实时监控对话流程
• 导出和共享对话分析

安装

首先，从以下位置获取 WandB API 密钥：https://wandb.ai/settings#api

可以通过将以下 json 添加到您的 Claude 桌面配置来安装此服务器：

{
  "mcpServers": {
    "MCP Telemetry": {
      "command": "uv", -- 这需要是 uv 可用的位置，通过 'which uv' 检查
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "weave",
        "mcp",
        "run",
        "~/mcp-telemetry/server.py"
      ],
      "env": {
        "WANDB_API_KEY": "..." -- 从 wandb.com 获取一个
      }
    }
  }
}

用法

安装完成后，MCP 遥测服务器将在您启动 Claude 时自动启动。它将开始收集所有对话的遥测数据。您可以在 Weights & Biases 仪表板中查看您的遥测数据。

基本用法

1. 与 Claude 开始对话
2. 服务器将自动跟踪：
   • 用户消息
   • LLM 响应
   • 工具调用及其结果
   • 对话元数据

配置

可以通过环境变量配置服务器：

• WANDB_API_KEY - 您的 Weights & Biases API 密钥（必需）

示例

启动跟踪会话

提示 Claude 跟踪该对话。示例：使用 MCP 遥测记录此对话，主题为 Cats

查看遥测数据

1. 登录到您的 Weights & Biases 帐户
2. 导航到您的项目
3. 您将看到各种可视化，包括：
   • 对话流程
   • 工具使用模式
   • 响应时间
   • 错误率

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。