langfuse

Langfuse MCP サーバー

Langfuse の LLM トレースとオブザベーションを読み取り専用で分析するための MCP サーバーです。エージェントがトレースデータを詳しく調査し、LLM パイプラインをデバッグし、コストとレイテンシーを分析できるように設計されています。

主な機能

• 名前、ユーザー、セッション、タグ、タイムスタンプ、環境でトレースを閲覧・フィルタリング
• すべてのネストされたオブザベーションとスコアを含む、トレースの詳細全体を確認
• タイプ（GENERATION、SPAN、EVENT）、モデル、レベルなどでオブザベーションを一覧表示・フィルタリング
• 大きなペイロード（1000 文字超）を /tmp ファイルに自動で切り詰め、grep で検索しやすい参照を付与
• 読み取り専用 — 書き込み操作はなく、データを変更するリスクなしで安全に使用可能

機能

ツール

ツール	説明
get_traces	フィルタリングとページネーションを使用してトレースを一覧表示します。最小限の概要を返します（I/O フィールドなし）。
get_trace_detail	ID でトレース全体を取得します。オブザベーション、スコア、入力／出力、メタデータを含みます。
get_observations	traceId、タイプ、レベルなどでフィルタリングしてオブザベーションを一覧表示します。最小限の概要を返します。
get_observation	ID でオブザベーション全体を取得します。入力、出力、モデルパラメーター、使用量、コストの詳細を含みます。

リソース

リソース	説明
langfuse://config	サーバーの設定とステータス（デバッグ用）

大きなペイロードの処理

トレースとオブザベーションのデータには、非常に大きな入力／出力フィールド（完全なプロンプト、生成結果など）が含まれることがよくあります。このサーバーは次の処理を自動で行います。

1. 1000 文字を超える文字列フィールドを切り詰めます
2. 全文を /tmp/langfuse_*.txt ファイルに保存します
3. 切り詰めた出力にファイルパスを含めます

エージェントは grep を使ってこれらのファイル内を検索できるため、ペイロード全体をコンテキストに読み込まずに、特定の内容を探せます。

設定

環境変数

変数	必須	説明	デフォルト
LANGFUSE_SECRET_KEY	はい	Langfuse のシークレットキー（sk-lf-...）	-
LANGFUSE_PUBLIC_KEY	はい	Langfuse の公開キー（pk-lf-...）	-
LANGFUSE_BASE_URL	いいえ	Langfuse API のベース URL	https://cloud.langfuse.com

Claude Desktop の設定

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "langfuse": {
      "command": "npx",
      "args": ["-y", "langfuse-observability-mcp-server"],
      "env": {
        "LANGFUSE_SECRET_KEY": "sk-lf-your-secret-key",
        "LANGFUSE_PUBLIC_KEY": "pk-lf-your-public-key",
        "LANGFUSE_BASE_URL": "https://us.cloud.langfuse.com"
      }
    }
  }
}

開発

# Install dependencies
npm run install-all

# Build
npm run build

# Development mode
npm run dev

# Run functional tests
npm test

# Run integration tests
npm run test:integration

# Run manual tests (requires .env with real credentials)
npm run test:manual

ライセンス

MIT