Langfuse MCP

Langfuse MCP — MCP-сервер сообщества (автор — avivsinai). Доступ к телеметрии Langfuse на естественном языке. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
avivsinai
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
python

Уровень риска: high

Создаёт промпты и метки, датасеты, прогоны и очереди разметки в Langfuse, удаляет элементы; режим full_json_file пишет файлы. Есть --read-only.

Настройка клиентов

codex
{
    "code": "# Codex CLI (user-scoped, stored in ~/.codex/config.toml)\ncodex mcp add langfuse \\\n  --env LANGFUSE_PUBLIC_KEY=pk-... \\\n  --env LANGFUSE_SECRET_KEY=sk-... \\\n  --env LANGFUSE_HOST=https://cloud.langfuse.com \\\n  -- uvx langfuse-mcp",
    "file": "~/.codex/config.toml",
    "lang": "bash",
    "notes": "Область пользователя",
    "verified": "docs"
}

Что умеет

Langfuse MCP Server — локальный MCP-сервер и навык для Langfuse, платформы наблюдаемости LLM-приложений. Он помогает отлаживать трейсы, сессии и исключения из Claude Code, Codex, Cursor и любого MCP-клиента. Это неофициальный проект: официальный Langfuse MCP авторы советуют для размещённого доступа к более широкому API (запись оценок, комментарии, модели, медиа), а этот — для локальной отладки.

48 инструментов по группам:

  • Трейсы и наблюдения — fetch_traces, fetch_trace, fetch_observations, fetch_observation.
  • Решения маршрутизации — поиск, детали и сводка решений роутера, поиск решений с низкой уверенностью.
  • Сессии — список, детали, сессии пользователя.
  • Исключения — find_exceptions (группировка по файлу, топ-50 групп), исключения в файле, детали, число ошибок.
  • Промпты — список, получение, создание текстовых и чатовых промптов, смена меток.
  • Датасеты — чтение, создание датасетов и элементов (upsert по item_id), удаление элементов, прогоны.
  • Очереди разметки — создание очередей и элементов, изменение.
  • Оценки, метрики, схема — чтение оценок, query_metrics (стоимость, задержка, токены по моделям на стороне сервера) и схема данных.

Управление объёмом. --tools загружает только нужные группы (traces, prompts и другие), чтобы сэкономить токены. Режим вывода — компактный, полный JSON строкой или полный JSON в файл. --read-only или LANGFUSE_MCP_READ_ONLY=true отключает все операции записи.

В репозитории есть навык langfuse для Claude Code и Codex со сценариями отладки трейсов, разбора исключений, анализа задержек и работы с промптами.

Кому подойдёт

  • Разработчикам LLM-приложений на Langfuse Cloud или собственном сервере.
  • Тем, кто разбирает ошибки и медленные сессии прямо из агента.
  • Командам, следящим за стоимостью инференса по моделям.

Похожие серверы — в категории разработка.

Установка

Нужны uv и Python 3.10+. Ключи берутся в Langfuse Cloud → Settings → API Keys; для своей установки укажите её адрес в LANGFUSE_HOST. Сервер запускается командой uvx langfuse-mcp. Для нескольких проектов есть профили (--profile prod, --profile staging) и общий HTTP-сервер, а также запуск в Docker.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

# Claude Code (project-scoped, shared via .mcp.json)
claude mcp add \
  -e LANGFUSE_PUBLIC_KEY=pk-... \
  -e LANGFUSE_SECRET_KEY=sk-... \
  -e LANGFUSE_HOST=https://cloud.langfuse.com \
  --scope project \
  langfuse -- uvx langfuse-mcp

Комментарии в командах: для Claude Code сервер добавляется в область проекта и попадает в общий .mcp.json, для Codex — в пользовательский ~/.codex/config.toml. Конфиг Cursor кладётся в .cursor/mcp.json проекта или ~/.cursor/mcp.json. После перезапуска проверьте подключение: /mcp в Claude Code или codex mcp list.

Проверка

Спросите: «Найди исключения за последние сутки» — сработает find_exceptions.

Примеры задач

Почему сессия этого пользователя была медленной? Покажи самые долгие наблюдения.
Сколько стоил инференс за последние 24 часа и какая задержка p95 по каждой модели?

Риски

  • Изменения в проекте Langfuse. Сервер создаёт промпты и меняет их метки, создаёт и удаляет элементы датасетов и прогоны, меняет очереди разметки. Используйте --read-only, если запись не нужна.
  • Файлы на диске. Режим full_json_file сохраняет полные ответы в файлы.
  • Ключи. Секретный ключ Langfuse даёт доступ к трейсам с данными пользователей; храните его в переменных окружения.

Частые вопросы

Чем отличается от официального Langfuse MCP?

Он для локальной отладки трейсов и исключений; официальный — для размещённого доступа к более широкому API.

Можно ли запретить запись?

Да, флаг --read-only или LANGFUSE_MCP_READ_ONLY=true.

Работает ли с собственным сервером Langfuse?

Да, укажите его адрес в LANGFUSE_HOST; метрики v2 доступны только в Langfuse Cloud.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Scrapling MCP Server

Веб-скрапинг Scrapling: скрытные HTTP-запросы, настоящие браузеры и CSS-селекторы.

Риск: medium Лицензия: BSD-3-Clause ★ 104 215

World Monitor

Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.

Риск: medium Лицензия: AGPL-3.0 ★ 90 905

mcp

Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Netdata

Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.

Риск: medium Лицензия: GPL-3.0 ★ 81 465

Источники