/ Каталог / Песочница / Langfuse MCP
● Официальный langfuse ⚡ Сразу

Langfuse MCP

автор langfuse · langfuse/mcp-server-langfuse

Manage Langfuse LLM-observability prompts from your agent.

Langfuse is open-source LLM observability and prompt management. This MCP lets Claude read prompt versions, fetch traces, and update prompt templates — useful for prompt engineers who want their assistant to actually touch the prompt store.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

langfuse-mcp.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "langfuse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "langfuse-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@langfuse/mcp-server"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "langfuse-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@langfuse/mcp-server"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add langfuse-mcp -- npx -y @langfuse/mcp-server

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Langfuse MCP

Iterate on a production prompt with traceable versions

👤 Prompt engineers ⏱ ~15 min intermediate

Когда использовать: You want to A/B a prompt without leaving the chat.

Предварительные требования
  • Server/skill installed and authenticated — See repo README
Поток
  1. Pull the current production prompt
    Get the 'support-triage' prompt labeled 'production' from Langfuse.✓ Скопировано
    → Current prompt text + version number
  2. Test a tweak
    Create version with my proposed change labeled 'staging'. Don't promote.✓ Скопировано
    → New version saved, 'production' label untouched

Итог: Versioned, reviewable prompt history.

Подводные камни
  • Labels are mutable — Labels are mutable — moving 'production' to a new version is an instant rollout. Confirm before relabel.
Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

langfuse-mcp + filesystem

Pair with filesystem for complementary capabilities

Use this server together with filesystem to complete a multi-step task.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
get_prompt name, version|label Retrieve a prompt for inspection or copying 1 API call
create_prompt name, prompt_text, labels Save a new version 1 API call
list_traces user_id|session_id, limit Debug a specific user/session 1 API call

Стоимость и лимиты

Во что обходится

Квота API
See provider docs for rate limits
Токенов на вызов
Varies by tool
Деньги
See repo README for pricing details
Совет
Cache tool results and avoid repeated identical calls.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Use environment variables; never commit secrets
Исходящий трафик: Tool calls go to the provider's API as documented

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized

Create a project in Langfuse, generate a key pair, set LANGFUSE_PUBLIC_KEY and LANGFUSE_SECRET_KEY.

Проверить: get_prompt on a known name works
prompt not found

Prompts are project-scoped. Confirm LANGFUSE_HOST and that the prompt exists in the target project.

Проверить: Open the Langfuse UI for that project

Альтернативы

Langfuse MCP в сравнении

АльтернативаКогда использоватьКомпромисс
comet-ml/opik-mcpYou already use Opik for tracingSimilar feature set; different vendor

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills