MCP Telemetry

MCP テレメトリ

概要

MCP テレメトリは、ユーザーと LLM の間の会話を記録、追跡するためのシンプルなインターフェースを提供します。Model Context Protocol を利用して、会話の追跡や分析に使えるテレメトリツールを公開します。

機能

• カスタム識別子を使用してトレースセッションを開始
• 次の項目を含む包括的な会話データを記録：
  • ユーザー入力
  • LLM の応答
  • LLM のアクション
  • ツールの呼び出しとその結果
• 可視化や分析のための 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 Telemetry サーバーが自動的に起動します。すべての会話のテレメトリデータの収集を開始します。テレメトリデータは Weights & Biases ダッシュボードで確認できます。

基本的な使い方

1. Claude で会話を開始します
2. サーバーは次の項目を自動的に追跡します：
   • ユーザーメッセージ
   • LLM の応答
   • ツールの呼び出しとその結果
   • 会話のメタデータ

設定

サーバーは環境変数を使って設定できます：

• WANDB_API_KEY - Weights & Biases API キー（必須）

例

トレースセッションの開始

Claude に会話をトレースするようプロンプトを入力します。例：Log this conversation with MCP Telemetry, topic will be Cats

テレメトリデータの表示

1. Weights & Biases アカウントにログインします
2. プロジェクトに移動します
3. 次のようなさまざまな可視化を確認できます：
   • 会話の流れ
   • ツールの使用パターン
   • 応答時間
   • エラー率

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルをご覧ください。