Langfuse Prompt Management

官方

用于协作编辑、版本管理、评估和发布提示词的开源工具。

你可以用 Langfuse Prompt Management MCP 做什么?

  • 列出生产提示 — 通过 prompts/listget-prompts 发现 Langfuse 中所有标记为 production 的提示,支持基于游标的分页。
  • 检索编译后的提示 — 使用 prompts/getget-prompt 按名称获取特定提示,并使用提供的变量进行编译。
  • 以 JSON 形式传递提示变量 — 在检索提示时,向 arguments 参数提供一个变量值的 JSON 对象。

文档

Langfuse 提示管理 MCP 服务器

模型上下文协议(MCP)服务器,用于 Langfuse 提示管理。通过此服务器,您可以通过模型上下文协议访问和管理您的 Langfuse 提示。

演示

在 Claude Desktop 中快速演示 Langfuse 提示 MCP(取消静音以收听语音解说):

https://github.com/user-attachments/assets/61da79af-07c2-4f69-b28c-ca7c6e606405

功能

MCP 提示

此服务器实现了 MCP 提示规范,用于提示的发现和检索。

  • prompts/list:列出所有可用的提示

    • 可选的基于游标的分页
    • 返回提示名称及其所需参数,限制:所有参数均假定为可选,且不包含描述,因为 Langfuse 中的变量没有规范
    • 如果提示超过 1 页,则包含用于分页的下一个游标
  • prompts/get:获取特定提示

    • 将 Langfuse 提示(文本和聊天)转换为 MCP 提示对象
    • 使用提供的变量编译提示

工具

为了提高与不支持提示功能的其他 MCP 客户端的兼容性,服务器还导出了复制 MCP 提示功能的工具。

  • get-prompts:列出可用的提示

    • 可选的 cursor 参数用于分页
    • 返回带有参数的提示列表
  • get-prompt:检索并编译特定提示

    • 必需的 name 参数:要检索的提示名称
    • 可选的 arguments 参数:包含提示变量的 JSON 对象

开发

npm install

# build current file
npm run build

# test in mcp inspector
npx @modelcontextprotocol/inspector node ./build/index.js

使用方法

步骤 1:构建

npm install
npm run build

步骤 2:将服务器添加到您的 MCP 服务器:

Claude Desktop

通过编辑 claude_desktop_config.json 配置 Claude for Desktop

{
  "mcpServers": {
    "langfuse": {
      "command": "node",
      "args": ["<absolute-path>/build/index.js"],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "your-public-key",
        "LANGFUSE_SECRET_KEY": "your-secret-key",
        "LANGFUSE_BASEURL": "https://cloud.langfuse.com"
      }
    }
  }
}

确保将环境变量替换为您实际的 Langfuse API 密钥。服务器现在将可在 Claude Desktop 中使用。

Cursor

向 Cursor 添加新服务器:

  • 名称:Langfuse Prompts
  • 类型:command
  • 命令:
    LANGFUSE_PUBLIC_KEY="your-public-key" LANGFUSE_SECRET_KEY="your-secret-key" LANGFUSE_BASEURL="https://cloud.langfuse.com" node absolute-path/build/index.js
    

限制

MCP 服务器仍在开发中,存在一些限制:

  • 仅返回 Langfuse 中带有 production 标签的提示
  • 所有参数均假定为可选,且不包含描述,因为 Langfuse 中的变量没有规范
  • 列表操作需要在后台单独获取每个提示以提取参数,这虽然可行但效率不高

欢迎贡献!如果您有任何建议或反馈,请提交 issue 或 PR(仓库)。