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.
Настройка клиентов
{
"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-селекторы.
World Monitor
Глобальная аналитика в реальном времени: конфликты, рынки, энергетика, торговля, судоходство и кибербезопасность.
mcp
Поиск, отчёты и анализ первопричин по метрикам, логам, системам, контейнерам и сетевым соединениям в Netdata.
Netdata
Мониторинг инфраструктуры Netdata: метрики, логи, алерты и поиск аномалий с ML.