Langfuse Prompt Management

Servidor MCP de Gestión de Prompts de Langfuse

Servidor de Protocolo de Contexto de Modelo (MCP) para la Gestión de Prompts de Langfuse. Este servidor le permite acceder y gestionar sus prompts de Langfuse a través del Protocolo de Contexto de Modelo.

Demostración

Demostración rápida de Prompts MCP de Langfuse en Claude Desktop (active el sonido para explicaciones con voz en off):

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

Funcionalidades

Prompt MCP

Este servidor implementa la especificación de Prompts MCP para el descubrimiento y recuperación de prompts.

• prompts/list: Listar todos los prompts disponibles

  • Paginación opcional basada en cursor
  • Devuelve los nombres de los prompts y sus argumentos requeridos; limitación: se asume que todos los argumentos son opcionales y no incluyen descripciones, ya que las variables no tienen especificación en Langfuse
  • Incluye el siguiente cursor para paginación si hay más de 1 página de prompts

• prompts/get: Obtener un prompt específico

  • Transforma los prompts de Langfuse (texto y chat) en objetos de prompt MCP
  • Compila el prompt con las variables proporcionadas

Herramientas

Para aumentar la compatibilidad con otros clientes MCP que no soportan la capacidad de prompts, el servidor también exporta herramientas que replican la funcionalidad de los Prompts MCP.

• get-prompts: Listar prompts disponibles

  • Parámetro opcional cursor para paginación
  • Devuelve una lista de prompts con sus argumentos

• get-prompt: Recuperar y compilar un prompt específico

  • Parámetro requerido name: Nombre del prompt a recuperar
  • Parámetro opcional arguments: Objeto JSON con variables del prompt

Desarrollo

npm install

# build current file
npm run build

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

Uso

Paso 1: Compilar

npm install
npm run build

Paso 2: Agregar el servidor a sus servidores MCP:

Claude Desktop

Configure Claude for Desktop editando 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"
      }
    }
  }
}

Asegúrese de reemplazar las variables de entorno con sus claves API reales de Langfuse. El servidor estará ahora disponible para usar en Claude Desktop.

Cursor

Agregar nuevo servidor a Cursor:

• Nombre: Langfuse Prompts
• Tipo: command
• Comando:

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

Limitaciones

El Servidor MCP es un trabajo en progreso y tiene algunas limitaciones:

• Solo se devuelven los prompts con una etiqueta production en Langfuse
• Se asume que todos los argumentos son opcionales y no incluyen descripciones, ya que las variables no tienen especificación en Langfuse
• Las operaciones de listado requieren obtener cada prompt individualmente en segundo plano para extraer los argumentos; esto funciona pero no es eficiente

¡Las contribuciones son bienvenidas! Por favor, abra un issue o un PR (repositorio) si tiene alguna sugerencia o comentario.