MCP.so
登录

Langfuse MCP (MCP)

@avivsinai

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

avivsinai

关于 Langfuse MCP

A Model Context Protocol (MCP) server for Langfuse, enabling AI agents to query Langfuse trace data for enhanced debugging and observability

Langfuse MCP 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "skills",
        "add",
        "avivsinai/langfuse-mcp",
        "-g",
        "-y"
      ]
    }
  }
}

Langfuse MCP 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

点击上方按钮,在临时沙箱中运行此服务器并实时获取工具列表。

概览

What is Langfuse MCP?

Langfuse MCP is an agent-facing Model Context Protocol server and skill for Langfuse observability. It lets AI agents query traces, inspect generations, debug exceptions, analyze sessions, manage prompts, browse datasets, and understand what agents did in production.

How to use Langfuse MCP?

Install via uvx langfuse-mcp with Python 3.10+ and the uv runtime. Set environment variables LANGFUSE_PUBLIC_KEY, LANGFUSE_SECRET_KEY, and LANGFUSE_HOST (defaults to Langfuse Cloud). Add the server to an MCP client (Claude Code, Codex, Cursor) using the provided configuration commands or JSON files. Start the MCP client, then invoke tools directly or use the included agent skill for ready‑made debugging playbooks.

Key features of Langfuse MCP

  • 48 tools covering traces, observations, sessions, exceptions, prompts, datasets, annotation queues, scores, metrics, and schema.
  • Selective tool loading via --tools flag to reduce token overhead.
  • Read‑only mode (--read-only) disables all write operations.
  • Default output mode (--default-output-mode) for compact, full JSON string, or file output.
  • Support for HTTP transport with per‑project credentials via Authorization header.
  • Included agent skill with playbooks for trace debugging, exception triage, latency analysis, prompt management, and dataset work.

Use cases of Langfuse MCP

  • Debug failing agent runs by querying Langfuse traces and observations.
  • Find exceptions, slow generations, high‑latency spans, and affected users.
  • Inspect sessions and user journeys without leaving the agent workflow.
  • Manage prompt versions, labels, datasets, annotation queues, and scores.
  • Answer questions like “what failed?”, “why was this slow?”, or “which prompt version ran?”

常见问题

1

How does Langfuse MCP differ from the native Langfuse MCP?

Langfuse MCP is a local, debugging‑first server with compact trace inspection, exception triage, session analysis, and route‑decision tools. It does not mirror every native MCP tool; the native MCP is a hosted endpoint with a broader API surface.

2

What are the runtime requirements?

Python 3.10–3.14 and the `uv` package runner (for `uvx`). The server is verified on CI for those Python versions.

3

Can I load only specific tools?

Yes. Use `langfuse-mcp --tools traces,prompts` to load only the tool groups you need. Available groups include traces, observations, routing, sessions, exceptions, prompts, datasets, annotation_queues, scores, metrics, and schema.

4

Is there a read‑only mode?

Yes. Start with `langfuse-mcp --read-only` or set `LANGFUSE_MCP_READ_ONLY=true` to disable all write operations (e.g., creating prompts, datasets, annotation queue items).

5

How do I use Langfuse MCP with multiple Langfuse projects?

Run the server in HTTP transport mode with `--transport streamable-http`. Each MCP client passes its project credentials as a `Basic` `Authorization` header (base64(public_key:secret_key)). An absent header falls back to the server’s startup environment credentials.

评论

其他 分类下的更多 MCP 服务器