langfuse
Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP. Use when the request names Langfuse or asks to diagnose recorded AI behavior.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- langfuse
- version
- 0.14.0
- metadata
- { "compatibility": "claude-code, codex-cli", "short-description": "Langfuse observability via MCP" }
- description
- Investigate AI traces, observations, exceptions, latency, sessions, prompts, datasets, annotation queues, and scores through Langfuse MCP. Use when the request names Langfuse or asks to diagnose recorded AI behavior.
02 资源文件 3
- 参考文档references/setup.md5.4 KB
- 参考文档references/tool-reference.md26.2 KB
- 参考文档references/workflows.md7.1 KB
03 SKILL.md 正文
Langfuse
Use Langfuse evidence to move from a broad symptom to the relevant trace, observation, session, prompt, or dataset. Start with the narrowest read-only query that can locate the event, then inspect its concrete inputs, outputs, timing, and errors.
Route the task
- For trace, observation, exception, latency, or session diagnosis, read diagnostic and management workflows.
- For installation, credentials, tool groups, output defaults, connection failures, or empty results, read setup.
- For exact parameters, filters, pagination, output modes, and response shapes, read the tool reference.
A common investigation starts with fetch_traces(age=60) or
find_exceptions(age=1440, group_by="file"), then fetches the selected trace or
observation by ID. Use full_json_file only when the complete payload is needed;
exports can contain sensitive user data.
Evidence and mutation boundaries
-
Treat model names, prompts, timestamps, and other values in historical traces as recorded evidence. Do not rewrite or normalize old model identifiers to a current name such as
gpt-6-astra. -
Trace discovery and inspection are read-only. Prompt creation or relabeling, dataset changes, annotation-queue changes, and deletions mutate Langfuse; perform them only when the user requested that change.
-
Prefer read-only server mode for diagnostic work. It disables prompt and dataset write tools:
langfuse-mcp --read-only # or LANGFUSE_MCP_READ_ONLY=true -
Never commit Langfuse credentials. Keep public key, secret key, and host in the supported environment or MCP configuration described in the setup reference. Rotate any exposed key.
-
Preserve exact IDs and filters in findings so another reader can reproduce the query. State when pagination, lookback limits, or compact output limits the conclusion.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.