Langfuse Prompt Management

Serveur MCP de gestion des prompts Langfuse

Serveur Model Context Protocol (MCP) pour la gestion des prompts Langfuse. Ce serveur vous permet d'accéder et de gérer vos prompts Langfuse via le Model Context Protocol.

Démo

Démo rapide des prompts Langfuse MCP dans Claude Desktop (activez le son pour les explications en voix off) :

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

Fonctionnalités

Prompt MCP

Ce serveur implémente la spécification MCP Prompts pour la découverte et la récupération de prompts.

• prompts/list : Lister tous les prompts disponibles

  • Pagination optionnelle basée sur un curseur
  • Renvoie les noms des prompts et leurs arguments requis, limitation : tous les arguments sont supposés optionnels et n'incluent pas de descriptions car les variables n'ont pas de spécification dans Langfuse
  • Inclut le curseur suivant pour la pagination s'il y a plus d'une page de prompts

• prompts/get : Obtenir un prompt spécifique

  • Transforme les prompts Langfuse (texte et chat) en objets prompt MCP
  • Compile le prompt avec les variables fournies

Outils

Pour augmenter la compatibilité avec d'autres clients MCP qui ne prennent pas en charge la fonctionnalité de prompt, le serveur exporte également des outils qui reproduisent la fonctionnalité des prompts MCP.

• get-prompts : Lister les prompts disponibles

  • Paramètre optionnel cursor pour la pagination
  • Renvoie une liste de prompts avec leurs arguments

• get-prompt : Récupérer et compiler un prompt spécifique

  • Paramètre requis name : Nom du prompt à récupérer
  • Paramètre optionnel arguments : Objet JSON avec les variables du prompt

Développement

npm install

# build current file
npm run build

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

Utilisation

Étape 1 : Construction

npm install
npm run build

Étape 2 : Ajouter le serveur à vos serveurs MCP :

Claude Desktop

Configurez Claude for Desktop en modifiant 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"
      }
    }
  }
}

Assurez-vous de remplacer les variables d'environnement par vos véritables clés API Langfuse. Le serveur sera alors disponible dans Claude Desktop.

Cursor

Ajoutez un nouveau serveur à Cursor :

• Nom : Langfuse Prompts
• Type : command
• Commande :

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

Limitations

Le serveur MCP est en cours de développement et présente certaines limitations :

• Seuls les prompts avec un label production dans Langfuse sont renvoyés
• Tous les arguments sont supposés optionnels et n'incluent pas de descriptions car les variables n'ont pas de spécification dans Langfuse
• Les opérations de liste nécessitent de récupérer chaque prompt individuellement en arrière-plan pour extraire les arguments, cela fonctionne mais n'est pas efficace

Les contributions sont les bienvenues ! Veuillez ouvrir une issue ou une PR (dépôt) si vous avez des suggestions ou des retours.