Langfuse 提示管理 MCP 服务器

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

演示

在 Claude 桌面版中快速演示 Langfuse 提示 MCP (取消静音以听取语音说明):

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

功能

MCP 提示

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

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

  • 可选的基于游标的分页
  • 返回提示名称及其所需参数，限制：假设所有参数都是可选的，并且不包括描述，因为 Langfuse 中变量没有规范
  • 如果有超过一页的提示，则包含用于分页的下一个游标

• 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

使用方法

第一步：构建

npm install
npm run build

第二步：将服务器添加到您的 MCP 服务器中：

Claude 桌面版

通过编辑 claude_desktop_config.json 配置 Claude 桌面版

{
  "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 桌面版中使用该服务器了。

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 (仓库)。