Langfuse Prompt Management

官方

用於協作編輯、版本管理、評估與發布提示詞的開源工具。

文件

Langfuse 提示管理 MCP 伺服器

模型上下文協定 (MCP) 伺服器,用於 Langfuse 提示管理。此伺服器讓您可以透過模型上下文協定存取和管理您的 Langfuse 提示。

展示

在 Claude Desktop 中快速展示 Langfuse Prompts MCP(取消靜音以收聽語音解說):

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

功能

MCP 提示

此伺服器實作了 MCP Prompts 規範,用於提示的發現與擷取。

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

    • 可選的基於游標的分頁功能
    • 回傳提示名稱及其所需的引數,限制:所有引數皆假設為可選,且不包含描述,因為變數在 Langfuse 中沒有規範
    • 若提示超過一頁,則包含用於分頁的下一個游標
  • 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(儲存庫)。