MCP Server Langfuse

🚀 語境模型協議 (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 中變量沒有說明）
• 列表操作需要逐個提示在後臺獲取以提取參數，這雖然可行但效率不高

歡迎貢獻！如果有關於改進或反饋的想法，請通過 倉庫 提交問題或拉取請求。