Langfuse MCP Server

Langfuse 包含一个原生的 Model Context Protocol (MCP) server,让 AI 助手和 agent 能够以编程方式与你的 Langfuse 数据交互。

如果你对新工具有反馈或想法,请在 GitHub 上分享。

如果你在能够安装 CLI 工具并运行 bash 命令的环境中运行 AI agent,我们推荐使用 Langfuse Agent Skill 而非 MCP server。

这是用于 Langfuse 数据平台的经过身份验证的 MCP server。还有一个用于 Langfuse 文档的公共 MCP server(文档)。

配置

Langfuse MCP server 使用无状态架构,每个 API 密钥的作用域是特定项目。使用以下配置连接到 MCP server:

Cloud EU

• 端点:https://cloud.langfuse.com/api/public/mcp
• 传输:streamableHttp
• 身份验证:通过 authorization header 的 Basic Auth

Cloud US

• 端点:https://us.cloud.langfuse.com/api/public/mcp
• 传输:streamableHttp
• 身份验证:通过 authorization header 的 Basic Auth

Cloud Japan

• 端点:https://jp.cloud.langfuse.com/api/public/mcp
• 传输:streamableHttp
• 身份验证:通过 authorization header 的 Basic Auth

HIPAA US

• 端点:https://hipaa.cloud.langfuse.com/api/public/mcp
• 传输:streamableHttp
• 身份验证:通过 authorization header 的 Basic Auth

自托管

• 端点:https://your-domain.com/api/public/mcp
• 传输:streamableHttp
• 身份验证:通过 authorization header 的 Basic Auth
• 对于反向代理部署,请确保代理保留公共 Host header。如果 MCP 端点收到的是内部主机名,请将 LANGFUSE_MCP_ALLOWED_HOSTS 设置为 MCP 端点接受的精确附加主机名或来源的逗号分隔列表。否则你会得到 403 错误。

MCP Reference

MCP Reference 是当前 Langfuse MCP server、设置片段、工具、输入 schema 和生成的请求示例的权威来源。

读和写工具默认可用。 如果你只想使用只读工具,请用允许列表配置你的 MCP 客户端,以限制对写操作的访问。完整工具列表参见 MCP Reference。

设置

反馈

我们很乐意听到你使用 Langfuse MCP server 的体验。在我们的 GitHub Discussion 中分享你的反馈、想法和用例。

相关文档

• MCP Reference - MCP server、设置片段、工具、schema 和请求的参考
• 用 MCP 做提示词管理 - 提示词专属工作流和示例
• 提示词管理概览 - 了解 Langfuse 提示词管理
• Public API - 用于编程访问的 REST API
• Langfuse Agent Skill - 从你的编码 agent 使用 Langfuse 功能
• Langfuse for Agents - 面向编码 agent 的 skill、CLI 和 MCP server 概览