MCP Telemetry

🚀 MCP 遙測

MCP 遙測是一個模型上下文協議（MCP）服務器，專為聊天系統遙測設計，藉助 Weights & Biases Weave 實現數據的記錄與分析，助力用戶深入瞭解與大語言模型（LLM）的交互情況。

🚀 快速開始

MCP 遙測提供了一個簡單的接口，用於記錄和跟蹤用戶與大語言模型（LLM）之間的對話。它利用 模型上下文協議 曝露遙測工具，這些工具可以用來追查和分析對話。一旦安裝完成，MCP 遙測服務器將在啟動 Claude 時自動開始運行，開始收集所有對話的遙測數據，您可以在 Weights & Biases 儀表盤中查看這些數據。

✨ 主要特性

• 使用自定義標識符啟動會話的跟蹤。
• 記錄全面的對話數據，涵蓋用戶輸入、LLM 響應、LLM 行動、工具調用及其結果。
• 與 Weights & Biases Weave 平滑集成，便於進行可視化和分析。
• 即時監控對話流程。
• 支持導出並共享對話分析。

📦 安裝指南

首先，從 Weights & Biases 獲取一個 API Key。此服務器可以通過將以下 JSON 添加到您的 Claude 桌面配置中進行安裝：

{
  "mcpServers": {
    "MCP 遙測": {
      "command": "uv", -- 這裡需要是您可以使用的 uv 的位置，請通過 'which uv' 檢查
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "weave",
        "mcp",
        "run",
        "~/mcp-telemetry/server.py"
      ],
      "env": {
        "WANDB_API_KEY": "..." -- 從 wandb.com 獲取一個
      }
    }
  }
}

💻 使用示例

基本使用方法

1. 與 Claude 開始一次對話。
2. 該服務器將自動跟蹤：
   • 用戶消息
   • LLM 響應
   • 工具調用及其結果
   • 對話元數據

高級使用方法

開始一個跟蹤會話

提示 Claude 跟蹤該對話。示例：用 MCP 遙測記錄這次對話，主題是 Cats

查看遙測數據

1. 登錄到您的 Weights & Biases 帳戶。
2. 瀏覽到您的項目。
3. 您將看到各種可視化，包括對話流程、工具使用模式、響應時間、錯誤率。

📚 詳細文檔

配置

服務器可以通過環境變量進行配置：

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

🤝 貢獻

歡迎貢獻！請隨意提交拉取請求。

📄 許可證

此項目根據 MIT 許可證發佈。有關詳細信息，請參閱 LICENSE 文件。