langfuse-mcp
让AI直接查询Langfuse追踪数据，用于调试和分析Agent行为。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：langfuse-mcp。 它的用途是：让AI直接查询Langfuse追踪数据，用于调试和分析Agent行为。 完整的 Skill 内容见：https://321skill.com/skills/langfuse-mcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查一下用户ID为‘user_123’最近一次会话中，所有耗时超过5秒的生成步骤。”，AI会调用Langfuse工具，查询并返回该会话中的高延迟追踪片段，帮助你定位性能瓶颈。或者
对AI说：“分析一下过去一小时里，失败率最高的提示词版本是哪个？”，AI会查询相关数据并给出分析结果。
介绍
Langfuse MCP Server 是一个面向AI Agent的Model Context Protocol服务器和技能，它将Langfuse的观测能力直接集成到AI工作流中。它解决了开发者在生产环境中难以快速定位Agent失败原因、分析性能瓶颈和理解用户会话的问题。
通过安装此技能，AI助手（如Claude、Cursor）可以直接调用一系列工具，查询Langfuse中的追踪记录、检查生成内容、调试异常、分析用户会话，甚至管理提示词版本和数据集。这相当于为AI配备了一个生产环境的“调试控制台”。
该技能非常适合需要监控和优化AI应用在生产环境中表现的开发者、运维工程师和产品经理。无论是排查一次失败的Agent运行，还是分析某个用户的完整交互旅程，都可以在AI对话中直接完成，无需切换工具。
使用前，请确保您已在Langfuse Cloud或自托管实例上拥有API密钥。安装时需通过环境变量配置密钥和主机地址。该技能支持选择性加载工具组和只读模式，便于在安全要求较高的环境中使用。
核心特点
与官方的Langfuse MCP相比，此技能更侧重于本地化和调试优先的体验，提供了更紧凑的追踪摘要、异常分类工具、路由决策分析工作流，并内置了开箱即用的Agent调试技能剧本，在Token消耗上更有控制力。
注意事项
目前不支持写入评分、评论、模型或媒体文件，这些功能需使用官方的Langfuse MCP。
常见问题
这个技能和Langfuse官方的MCP有什么区别？
官方MCP是托管式、API导向的通用接口；而这个技能是本地部署、调试导向的，提供更紧凑的追踪摘要、异常分类和内置调试剧本，更适合Agent日常排错。
需要自己部署Langfuse吗？
不需要，可以使用Langfuse Cloud服务，只需提供API密钥即可。自托管Langfuse实例也支持。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/langfuse-mcp/raw/index.md 读取 langfuse-mcp 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/langfuse-mcp/raw/index.md（查看排版版本）