Langfuse Prompt Management

Servidor MCP de Gerenciamento de Prompts do Langfuse

Servidor do Model Context Protocol (MCP) para o Gerenciamento de Prompts do Langfuse. Este servidor permite que você acesse e gerencie seus prompts do Langfuse através do Model Context Protocol.

Demonstração

Demonstração rápida dos Prompts MCP do Langfuse no Claude Desktop (ative o som para explicações narradas):

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

Funcionalidades

Prompt MCP

Este servidor implementa a especificação de Prompts MCP para descoberta e recuperação de prompts.

• prompts/list: Lista todos os prompts disponíveis

  • Paginação opcional baseada em cursor
  • Retorna nomes de prompts e seus argumentos obrigatórios, limitação: todos os argumentos são considerados opcionais e não incluem descrições, pois as variáveis não possuem especificação no Langfuse
  • Inclui próximo cursor para paginação se houver mais de 1 página de prompts

• prompts/get: Obtém um prompt específico

  • Transforma prompts do Langfuse (texto e chat) em objetos de prompt MCP
  • Compila o prompt com as variáveis fornecidas

Ferramentas

Para aumentar a compatibilidade com outros clientes MCP que não suportam a capacidade de prompt, o servidor também exporta ferramentas que replicam a funcionalidade dos Prompts MCP.

• get-prompts: Lista prompts disponíveis

  • Parâmetro opcional cursor para paginação
  • Retorna uma lista de prompts com seus argumentos

• get-prompt: Recupera e compila um prompt específico

  • Parâmetro obrigatório name: Nome do prompt a ser recuperado
  • Parâmetro opcional arguments: Objeto JSON com variáveis do prompt

Desenvolvimento

npm install

# build current file
npm run build

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

Uso

Passo 1: Compilar

npm install
npm run build

Passo 2: Adicionar o servidor aos seus servidores MCP:

Claude Desktop

Configure o Claude para 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"
      }
    }
  }
}

Certifique-se de substituir as variáveis de ambiente pelas suas chaves de API reais do Langfuse. O servidor estará então disponível para uso no Claude Desktop.

Cursor

Adicione um novo servidor ao Cursor:

• Nome: 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
  

Limitações

O Servidor MCP está em desenvolvimento e possui algumas limitações:

• Apenas prompts com um rótulo production no Langfuse são retornados
• Todos os argumentos são considerados opcionais e não incluem descrições, pois as variáveis não possuem especificação no Langfuse
• Operações de listagem exigem a busca individual de cada prompt em segundo plano para extrair os argumentos; isso funciona, mas não é eficiente

Contribuições são bem-vindas! Por favor, abra uma issue ou um PR (repositório) se tiver sugestões ou feedback.