MCP Telemetry

MCP 遥测

概述

MCP 遥测提供了一个简单的接口，用于记录和跟踪用户与大模型之间的对话。它利用 Model Context Protocol 提供遥测工具，可用于追踪和分析对话。

功能

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

安装

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

将以下 JSON 添加到 Claude 桌面配置中，即可安装此服务：

{
  "mcpServers": {
    "MCP Telemetry": {
      "command": "uv", -- this needs to be the location where uv is available, check via 'which uv'
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "weave",
        "mcp",
        "run",
        "~/mcp-telemetry/server.py"
      ],
      "env": {
        "WANDB_API_KEY": "..." -- get one from wandb.com
      }
    }
  }
}

使用方法

安装后，启动 Claude 时，MCP 遥测服务将自动运行。它会开始收集所有对话的遥测数据。你可以在 Weights & Biases 控制面板中查看遥测数据。

基本用法

1. 与 Claude 开始对话
2. 服务将自动跟踪：
   • 用户消息
   • 大模型回复
   • 工具调用及其结果
   • 对话元数据

配置

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

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

示例

启动追踪会话

提示 Claude 追踪该对话。例如：Log this conversation with MCP Telemetry, topic will be Cats

查看遥测数据

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

贡献

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

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。