Langfuse Prompt Management

официальный

Open-source tool for collaborative editing, versioning, evaluating, and releasing prompts.

GitHub
166

Документация

Langfuse Prompt Management MCP-сервер

Model Context Protocol (MCP) сервер для Langfuse Prompt Management. Этот сервер позволяет получать доступ к вашим Langfuse-промптам и управлять ими через Model Context Protocol.

Демонстрация

Краткая демонстрация Langfuse Prompts MCP в Claude Desktop (включите звук для голосовых пояснений):

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

Возможности

MCP Prompt

Этот сервер реализует спецификацию MCP Prompts для обнаружения и получения промптов.

  • prompts/list: Вывести список всех доступных промптов

    • Опциональная курсорная пагинация
    • Возвращает имена промптов и их обязательные аргументы; ограничение: все аргументы считаются необязательными и не содержат описаний, поскольку переменные не имеют спецификации в Langfuse
    • Включает следующий курсор для пагинации, если промптов больше одной страницы

  • prompts/get: Получить конкретный промпт

    • Преобразует промпты Langfuse (текстовые и чатовые) в объекты MCP-промптов
    • Компилирует промпт с переданными переменными

Инструменты

Для повышения совместимости с другими MCP-клиентами, не поддерживающими возможность промптов, сервер также экспортирует инструменты, повторяющие функциональность MCP Prompts.

  • get-prompts: Вывести список доступных промптов

    • Опциональный параметр cursor для пагинации
    • Возвращает список промптов с их аргументами

  • get-prompt: Получить и скомпилировать конкретный промпт

    • Обязательный параметр name: Имя получаемого промпта
    • Опциональный параметр arguments: JSON-объект с переменными промпта

Разработка

npm install

# build current file
npm run build

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

Использование

Шаг 1: Сборка

npm install
npm run build

Шаг 2: Добавьте сервер к вашим MCP-серверам:

Claude Desktop

Настройте Claude for 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"
      }
    }
  }
}

Обязательно замените переменные окружения вашими реальными API-ключами Langfuse. Сервер станет доступен для использования в Claude Desktop.

Cursor

Добавьте новый сервер в Cursor:

  • Имя: Langfuse Prompts
  • Тип: command
  • Команда: 
    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-сервер находится в разработке и имеет некоторые ограничения:

  • Возвращаются только промпты с меткой production в Langfuse
  • Все аргументы считаются необязательными и не содержат описаний, поскольку переменные не имеют спецификации в Langfuse
  • Операции списка требуют фоновой выборки каждого промпта по отдельности для извлечения аргументов; это работает, но неэффективно

Приветствуются доработки! Пожалуйста, создайте issue или PR (репозиторий), если у вас есть предложения или отзывы.