Langfuse Prompt Management

Langfuse Prompt Management MCP Server

Model Context Protocol (MCP) Server für Langfuse Prompt Management. Dieser Server ermöglicht Ihnen den Zugriff auf und die Verwaltung Ihrer Langfuse-Prompts über das Model Context Protocol.

Demo

Kurzdemo von Langfuse Prompts MCP in Claude Desktop (Stummschaltung aufheben für Voice-Over-Erklärungen):

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

Funktionen

MCP Prompt

Dieser Server implementiert die MCP Prompts-Spezifikation für die Erkennung und den Abruf von Prompts.

• prompts/list: Alle verfügbaren Prompts auflisten

  • Optionale cursor-basierte Paginierung
  • Gibt Prompt-Namen und deren erforderliche Argumente zurück, Einschränkung: Alle Argumente werden als optional angenommen und enthalten keine Beschreibungen, da Variablen in Langfuse keine Spezifikation haben
  • Enthält nächsten Cursor für Paginierung, falls mehr als 1 Seite mit Prompts vorhanden ist

• prompts/get: Einen bestimmten Prompt abrufen

  • Transformiert Langfuse-Prompts (Text und Chat) in MCP-Prompt-Objekte
  • Kompiliert Prompt mit bereitgestellten Variablen

Werkzeuge

Um die Kompatibilität mit anderen MCP-Clients zu erhöhen, die die Prompt-Fähigkeit nicht unterstützen, exportiert der Server auch Werkzeuge, die die Funktionalität der MCP Prompts replizieren.

• get-prompts: Verfügbare Prompts auflisten

  • Optionaler cursor-Parameter für Paginierung
  • Gibt eine Liste von Prompts mit ihren Argumenten zurück

• get-prompt: Einen bestimmten Prompt abrufen und kompilieren

  • Erforderlicher name-Parameter: Name des abzurufenden Prompts
  • Optionaler arguments-Parameter: JSON-Objekt mit Prompt-Variablen

Entwicklung

npm install

# build current file
npm run build

# test in mcp inspector
npx @modelcontextprotocol/inspector node ./build/index.js

Verwendung

Schritt 1: Bauen

npm install
npm run build

Schritt 2: Server zu Ihren MCP-Servern hinzufügen:

Claude Desktop

Konfigurieren Sie Claude für Desktop, indem Sie claude_desktop_config.json bearbeiten

{
  "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"
      }
    }
  }
}

Stellen Sie sicher, dass Sie die Umgebungsvariablen durch Ihre tatsächlichen Langfuse-API-Schlüssel ersetzen. Der Server steht nun zur Verwendung in Claude Desktop bereit.

Cursor

Neuen Server zu Cursor hinzufügen:

• Name: Langfuse Prompts
• Typ: command
• Befehl:

  LANGFUSE_PUBLIC_KEY="your-public-key" LANGFUSE_SECRET_KEY="your-secret-key" LANGFUSE_BASEURL="https://cloud.langfuse.com" node absolute-path/build/index.js
  

Einschränkungen

Der MCP Server ist in Arbeit und weist einige Einschränkungen auf:

• Es werden nur Prompts mit einem production-Label in Langfuse zurückgegeben
• Alle Argumente werden als optional angenommen und enthalten keine Beschreibungen, da Variablen in Langfuse keine Spezifikation haben
• Listenoperationen erfordern das Abrufen jedes einzelnen Prompts im Hintergrund, um die Argumente zu extrahieren; dies funktioniert, ist aber nicht effizient

Beiträge sind willkommen! Bitte eröffnen Sie ein Issue oder eine PR (Repo), wenn Sie Vorschläge oder Feedback haben.