Langfuse Docs MCP Server
Langfuse Docs MCP server 将 Langfuse 文档暴露给 AI agent。
核心用例:使用 Cursor(或其他 AI 编码 agent)自动将 Langfuse Tracing 集成到你的代码库,详细指令和示例提示词参见入门。
这是用于 Langfuse 文档的公共 MCP server。还有一个经过身份验证的 MCP server,用于与 Langfuse 数据平台的其余部分集成(文档)。
安装
Cursor
通过一键安装将 Langfuse Docs MCP 添加到 Cursor:
手动配置
将以下内容添加到你的 mcp.json:
{
"mcpServers": {
"langfuse-docs": {
"url": "https://langfuse.com/api/mcp"
}
}
}
Copilot(VSCode 中)
通过一键安装将 Langfuse Docs MCP 添加到 VSCode 中的 Copilot:
手动配置
通过以下步骤将 Langfuse Docs MCP 添加到 VSCode 中的 Copilot:
- 打开命令面板(⌘+Shift+P)
- 打开 "MCP: Add Server..."
- 选择
HTTP - 粘贴
https://langfuse.com/api/mcp - 选择名称(例如
langfuse-docs)以及是否保存在用户或工作区设置中 - 完成!MCP server 现在在 Agent 模式下可用
Claude Code
通过 CLI 将 Langfuse Docs MCP 添加到 Claude Code:
claude mcp add \
--transport http \
langfuse-docs \
https://langfuse.com/api/mcp \
--scope user
手动配置
或者,将以下内容添加到你的设置文件:
- 用户作用域:
~/.claude/settings.json - 项目作用域:
your-repo/.claude/settings.json - 本地作用域:
your-repo/.claude/settings.local.json
{
"mcpServers": {
"langfuse-docs": {
"transportType": "http",
"url": "https://langfuse.com/api/mcp",
"verifySsl": true
}
}
}
单行 JSON 导入
claude mcp add-json langfuse-docs \
'{"type":"http","url":"https://langfuse.com/api/mcp"}'
添加后,启动 Claude Code 会话(claude)并输入 /mcp 以确认连接。
Windsurf
通过以下步骤将 Langfuse Docs MCP 添加到 Windsurf:
打开命令面板(⌘+Shift+P)
打开 "MCP Configuration Panel"
选择
Add custom server添加以下配置:
{ "mcpServers": { "langfuse-docs": { "command": "npx", "args": ["mcp-remote", "https://langfuse.com/api/mcp"] } } }
其他 MCP 客户端
Langfuse 使用 streamableHttp 协议与 MCP server 通信。大多数客户端都支持此协议。
{
"mcpServers": {
"langfuse-docs": {
"url": "https://langfuse.com/api/mcp"
}
}
}
如果你使用的客户端不支持 streamableHttp(例如 Windsurf),可以使用 mcp-remote 命令作为本地代理。
{
"mcpServers": {
"langfuse-docs": {
"command": "npx",
"args": ["mcp-remote", "https://langfuse.com/api/mcp"]
}
}
}
关于
- 端点:
https://langfuse.com/api/mcp - 传输:
streamableHttp - 身份验证:无
MCP Reference 是当前 Docs MCP 工具、输入 schema 和生成的请求示例的权威来源。
参考
- MCP server 的实现:route.ts
- MCP Reference:MCP server、设置片段、工具、schema 和请求的参考
- 由 MCP server 驱动的 Agentic Onboarding
- Ask AI:与 Langfuse 文档进行 RAG 聊天,获取问题答案
- langfuse.com/llms.txt:包含页面标题和指向详细子文件链接的简洁概览(llms-docs.txt、llms-integrations.txt、llms-self-hosting.txt)
REST 端点
底层的文档搜索(searchLangfuseDocs 工具)也作为独立的 REST API 提供,地址为 https://langfuse.com/api/search-docs。
curl "https://langfuse.com/api/search-docs?query=Langfuse+Docs+MCP+Server"
当你需要在 MCP 之外进行轻量级语义搜索时,直接使用此端点。