简介
langfuse-mcp 让 Langfuse 变成 Agent 可查询的上下文:助手能拉取真实 trace 与 prompt,用“证据”来调试、评估并迭代 Agent 行为。
最适合: Agent 可观测性、Prompt 调试、评估流程与复盘
适配: Langfuse Cloud 或自托管;MCP 客户端(Claude Code/Codex);通过环境变量配置 Key
配置时间: 10–15 分钟
关键事实(已验证)
- README 列出共 37 个工具,覆盖 traces/observations/sessions/prompts/datasets 等。
- README 支持用
--tools traces,prompts选择性加载工具组。 - GitHub:87 stars · 23 forks;最近更新 2026-05-06(GitHub API 验证)。
正文
用 langfuse-mcp 建立“可观测性闭环”的一个顺手流程:
- 让 Agent 在开启 tracing 的情况下复现问题。
- 用 MCP 拉取 trace,定位失败的 observation span。
- 拉取当时使用的 prompt 版本(含 labels),修复后再跑一遍验证。
共享环境建议先启用只读模式(--read-only)降低误操作风险。
README 原文节选(verbatim)
Langfuse MCP Server
Model Context Protocol server for Langfuse observability. Query traces, debug errors, analyze sessions, manage prompts.
Why langfuse-mcp?
Comparison with official Langfuse MCP (as of Jan 2026):
| langfuse-mcp | Official | |
|---|---|---|
| Traces & Observations | Yes | No |
| Sessions & Users | Yes | No |
| Exception Tracking | Yes | No |
| Prompt Management | Yes | Yes |
| Dataset Management | Yes | No |
| Annotation Queues | Yes | No |
| Scores (v2) | Yes | No |
| Selective Tool Loading | Yes | No |
This project provides a full observability toolkit — traces, observations, sessions, exceptions, prompts, datasets, annotation queues, and scores — while the official MCP focuses on prompt management.
Tools (37 total)
| Category | Tools |
|---|---|
| Traces | fetch_traces, fetch_trace |
| Observations | fetch_observations, fetch_observation |
| Sessions | fetch_sessions, get_session_details, get_user_sessions |
FAQ
如何鉴权? 答:README 通过环境变量提供 LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY 与 LANGFUSE_HOST。
能限制加载范围吗?
答:可以用 --tools 只加载需要的工具组。
有没有安全模式?
答:README 提供 --read-only / LANGFUSE_MCP_READ_ONLY=true 只读模式。