Langfuse MCP Server Langfuse

🚀 语言融合提示管理 MCP 服务器

本项目是为 Langfuse 提示管理 实现的 Model Context Protocol (MCP) 服务器。借助该服务器，您能够通过 Model Context Protocol 对 Langfuse 提示进行访问和管理。

🚀 快速开始

构建

npm install
npm run build

将服务器添加到您的 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 提示
• 类型：命令
• 命令：

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 提示

此服务器实现了 MCP 提示规范 以进行提示发现和检索。

• prompts/list：列出所有可用提示
  • 支持可选的基于游标的分页
  • 返回提示名称及其所需参数，需注意：所有参数均假设为可选，且不包含描述，因为 Langfuse 中变量没有明确说明
  • 如果有更多页面的提示，则返回下一个游标
• prompts/get：获取特定提示
  • 将 Langfuse 提示（文本和聊天）转换为 MCP 提示对象
  • 使用提供的变量编译提示

工具

为了提高与其他不支持提示功能的 MCP 客户端的兼容性，此服务器还导出了工具，以模拟提示功能。

• get-prompts：列出可用提示
  • 可选的 cursor 参数用于分页
  • 返回提示列表及其参数
• get-prompt：检索并编译特定提示
  • 必需的 name 参数：要检索的提示名称
  • 可选的 arguments 参数：包含提示变量的 JSON 对象

📺 演示

在 Claude Desktop 中快速演示 Langfuse Prompts MCP（带有语音讲解，请取消静音）： 视频链接

🛠️ 开发

npm install

# 构建当前文件
npm run build

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

⚠️ 局限性

此 MCP 服务器目前还有一些限制：

• 只返回 Langfuse 中带有 production 标记的提示
• 所有参数均假设为可选，并不包含描述，因为变量在 Langfuse 中没有明确说明
• 列表操作需要逐个提示地在后台获取以提取参数，这虽然可行但效率不高

欢迎贡献！如果对项目有任何建议或反馈，请通过问题或拉取请求（仓库）联系我们。