Langfuse Prompt Management MCP Server

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

演示

快速演示 Langfuse 提示 MCP 在 Claude Desktop 中的应用（取消静音以获取语音解释）：

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

# 构建当前文件
npm run build

# 在 MCP 检查器中测试
npx @modelcontextprotocol/inspector node ./build/index.js

使用

第一步：构建

npm install
npm run build

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

Claude Desktop

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

{
  "mcpServers": {
    "langfuse": {
      "command": "node",
      "args": ["<绝对路径>/build/index.js"],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "您的公钥",
        "LANGFUSE_SECRET_KEY": "您的私钥",
        "LANGFUSE_BASEURL": "https://cloud.langfuse.com"
      }
    }
  }
}

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

Cursor

在 Cursor 中添加新服务器：

• 名称：Langfuse 提示
• 类型：命令
• 命令：

  LANGFUSE_PUBLIC_KEY="您的公钥" LANGFUSE_SECRET_KEY="您的私钥" LANGFUSE_BASEURL="https://cloud.langfuse.com" node 绝对路径/build/index.js
  

限制

MCP 服务器仍在开发中，存在一些限制：

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

欢迎贡献！如果您有任何建议或反馈，请打开一个问题或 PR（仓库）。