语境模型协议 (MCP) 服务器 - Langfuse 提示管理

MCP 服务器介绍

该服务器实现了 Langfuse 提示管理 的 Model Context Protocol (MCP)，允许您通过 Model Context Protocol 访问和管理您的 Langfuse 提示。

功能概览

MCP 提示功能

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

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

  • 可选分页游标
  • 返回提示名称及其所需参数，限制：所有参数均假设为可选且不包含描述（因为 Langfuse 中变量没有说明）
  • 如果还有更多提示页面，则返回下一页的游标

• prompts/get：获取特定提示

  • 将 Langfuse 提示（文本和对话）转换为 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 文件：

{
  "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 中添加

• 名称：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 服务器仍处于开发阶段，存在一些局限性：

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

欢迎贡献！如果有关于改进或反馈的想法，请通过 仓库 提交问题或拉取请求。