Langfuse Prompt Management MCP Server

Langfuse 提示词管理 MCP 服务

用于 Langfuse 提示词管理的 Model Context Protocol (MCP) 服务。此服务可让你通过 Model Context Protocol 访问和管理 Langfuse 提示词。

演示

在 Claude Desktop 中快速演示 Langfuse Prompts MCP（取消静音以收听语音说明）：

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

功能

MCP 提示词

此服务实现了用于发现和获取提示词的 MCP Prompts 规范。

• prompts/list：列出所有可用提示词

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

• prompts/get：获取指定提示词

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

工具

为提高与其他不支持提示词功能的 MCP 客户端的兼容性，此服务还导出了可复现 MCP Prompts 功能的工具。

• 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（仓库）。