金大哥 - mcp-server-langfuse MCP 详情

article

README

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

该服务器主要用于实现 Langfuse 提示管理的 Model Context Protocol (MCP)，借助此协议，你能够便捷地访问和管理自己的 Langfuse 提示。

🚀 快速开始

开发步骤

# 安装依赖
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 提示功能

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

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

工具扩展

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

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

🔧 技术细节

当前 MCP 服务器仍处于开发阶段，存在一些局限性：

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

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

mcp-server-langfuse