Logfire MCP

🚀 Logfire MCP サーバー

このリポジトリには、モデルコンテキストプロトコル (MCP) サーバーが含まれており、このサーバーには、Logfire に送信された OpenTelemetry のトレースとメトリクスにアクセスするためのツールが備わっています。

🚀 クイックスタート

1. Logfire アクセストークンの取得：

   • Logfire コンソールにアクセスし、アクセストークンを作成して取得します。

2. MCP サーバーの起動：

   uvx logfire-mcp --read-token=YOUR_TOKEN
   

3. クライアントの設定：

   • 使用するツール（Cursor、Claude Desktop、Cline など）に応じて、対応する設定例を参考に設定します。

4. 使用開始：

   • MCP サーバーが提供するツールを使用して、OpenTelemetry のトレースとメトリクスデータを分析します。

✨ 主な機能

Logfire MCP サーバーは以下の機能を提供します：

1. トレースデータの分析：アプリケーション内の異常を識別して分類するのに役立ちます。
2. メトリクスのクエリ：柔軟なクエリ機能を提供し、必要なデータを取得するのに役立ちます。
3. 統合ツール：複数の開発環境やフレームワークとの統合をサポートします。

📦 ツールリスト

以下は MCP サーバーが提供する主なツールです：

find_exceptions

• 説明：指定された期間内のすべての異常を検索します。
• パラメータ：
  • age (int): 時間範囲（分単位）。デフォルト値は 60 です。
• 戻り値：

  [
    {
      "filepath": string,
      "count": int
    }
  ]
  

find_exceptions_in_file

• 説明：指定されたファイル内の異常を検索します。
• パラメータ：
  • filepath (string): ファイルパス。
  • age (int): 時間範囲（分単位）。デフォルト値は 60 です。
• 戻り値：

  [
    {
      "created_at": string,
      "message": string,
      "exception_type": string,
      "exception_message": string,
      "function_name": string,
      "line_number": string,
      "attributes": object,
      "trace_id": string
    }
  ]
  

arbitrary_query

• 説明：カスタムクエリを実行できます。
• パラメータ：
  • query (string): SQL クエリ文。
  • age (int): 時間範囲（分単位）。デフォルト値は 60 です。
• 戻り値：

  [
    {
      "trace_id": string,
      "message": string,
      "created_at": string,
      "service_name": string
    }
  ]
  

💻 使用例

基本的な使用法

# サーバーの起動
uvx logfire-mcp --read-token=YOUR_TOKEN

高度な使用法

# カスタムクエリの実行
uvx logfire-mcp --read-token=YOUR_TOKEN --query="SELECT * FROM traces WHERE timestamp > '2024-01-01'"

📚 サンプル質問

1. “過去 1 時間ですべてのサービスで発生した異常は何ですか？”
2. “ファイル 'app/api.py' の最近のエラーとそのコンテキストトレース情報を表示してください。”
3. “昨日 1 分間に何回のエラーが発生しましたか？”
4. “サービス名で分類した最も一般的な異常タイプは何ですか？”
5. “OpenTelemetry のトレースとメトリクスのスキーマ情報を取得します”
6. “昨日のすべてのエラーを検索し、そのコンテキストトレース情報を表示します”

🤝 プロジェクトへの貢献

コミュニティからの貢献を歓迎しています。新機能の追加、問題の修正、ドキュメントの改善など、どのような形でも歓迎します。

詳細な実装例や開発パターンについては、モデルコンテキストプロトコルサーバーリポジトリを参照してください。

📄 ライセンス

Logfire MCP サーバーは MIT ライセンスの下で提供されています。これは、MIT ライセンスの条項に従う限り、あらゆるプロジェクトでこのソフトウェアを自由に使用、修正、配布できることを意味します。