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 中沒有明確說明
• 列表操作需要逐個提示地在後臺獲取以提取參數，這雖然可行但效率不高

歡迎貢獻！如果對項目有任何建議或反饋，請通過問題或拉取請求（倉庫）聯繫我們。