Каталог MCP
hugoles/langfuse-mcp

hugoles/langfuse-mcp

Name: hugoles/langfuse-mcp
Availability: InStock
Author: hugoles

Сервер MCP, открывающий Langfuse API для ИИ-ассистентов. Позволяет запрашивать трассировки, оценки, промпты и метрики, не покидая чат. Подходит для отладки ошибок LLM и мониторинга затрат.

README

27 инструментов

Версии

Установить сервер

langfuse-mcp

An MCP server that exposes the Langfuse REST API as tools, so Claude (or any MCP client) can query your traces, observations, sessions, scores, prompts, datasets, and metrics during a conversation.

Useful when you want to ask things like:

"Why did trace abc123 fail? Walk me through its observations."
"List the 5 most recent traces with level=ERROR for user alice@x.com."
"Summarize today's generation cost broken down by model."
"Show me the production version of prompt customer-support-v2."

…without leaving your assistant.

Requirements

Node.js 20 or newer (node --version).
A Langfuse project with API keys (cloud.langfuse.com → Settings → API Keys on EU cloud, us.cloud.langfuse.com on US cloud, or your self-hosted instance).

Tools

All tools are read-only and call the Langfuse Public API over HTTPS using your project keys for Basic Auth.

Traces & observations

Tool	Description
`listTraces`	List traces with filters. Returns summary metadata.
`getTrace`	Fetch a single trace by id including the full observation tree.
`listObservations`	List spans, generations, and events with filters.
`getObservation`	Fetch a single observation by id.

Инструменты были проиндексированы: 09.09.2026

getComment

Получает один комментарий по его идентификатору.

Получает комментарий по id

Параметры

commentIdstringобязательный

getDailyMetrics

Получает ежедневные агрегированные метрики использования/стоимости/количества для трассировок и наблюдений.

Получает сводку ежедневных метрик

Параметры

environmentstring
fromTimestampstring
limitinteger
Items per page (default 50, max 100)
pageinteger
Page number (default 1)
tagsstring[]
toTimestampstring
traceNamestring
userIdstring

getDataset

Получает метаданные для набора данных по его имени.

Получает набор данных по имени

Параметры

datasetNamestringобязательный

getDatasetItem

Получает один элемент набора данных по идентификатору.

Получает элемент набора данных по идентификатору

Параметры

itemIdstringобязательный

getDatasetRun

Получает конкретный запуск датасета по имени.

Получает прогон набора данных.

Параметры

datasetNamestringобязательный
runNamestringобязательный

getHealth

Пингует публичный health endpoint Langfuse. Полезно для проверки учётных данных и подключения.

Проверяет работоспособность API Langfuse

Параметры

Без параметров.

getMedia

Получает метаданные для вложенного медиафайла (изображения, аудио, файла) по идентификатору.

Получает метаданные медиа-вложения.

Параметры

mediaIdstringобязательный

getMetrics

Выполняет запрос метрик (количество, задержка, стоимость, использование токенов). Передаёт строку запроса JSON в соответствии с API метрик Langfuse.

Запрашивает метрики Langfuse

Параметры

querystringобязательный
JSON metrics query (view, dimensions, metrics, filters, fromTimestamp, toTimestamp). See Langfuse docs.

getModel

Получает определение одной модели по идентификатору.

Получает модель по идентификатору.

Параметры

modelIdstringобязательный

getObservation

Извлекает одно наблюдение по идентификатору.

Получает наблюдение по идентификатору.

Параметры

observationIdstringобязательный

getPrompt

Получает промпт по имени. Опционально закрепляет за конкретной версией или меткой (например, 'production').

Получает подсказку (опционально конкретную версию или метку)

Параметры

labelstring
Specific label to fetch (e.g. 'production')
promptNamestringобязательный
versioninteger
Specific version to fetch (defaults to latest production)

getScore

Получает один результат по идентификатору.

Получает одну оценку по идентификатору.

Параметры

scoreIdstringобязательный

getScoreConfig

Получает одну конфигурацию оценки по идентификатору.

Получает конфигурацию score по идентификатору.

Параметры

configIdstringобязательный

getSession

Получает сессию по id, включая её трейсы.

Получает сеанс с его трассировками

Параметры

sessionIdstringобязательный

getTrace

Извлекает один trace по id, включая все вложенные наблюдения.

Получает трассировку с полным деревом наблюдений

Параметры

traceIdstringобязательный

listComments

Перечисляет комментарии, прикреплённые к трассировкам, наблюдениям, сессиям или промптам.

Выводит список комментариев

Параметры

authorUserIdstring
limitinteger
Items per page (default 50, max 100)
objectIdstring
objectTypeenum
Filter by attached object type
pageinteger
Page number (default 1)

listDatasetItems

Перечисляет элементы в датасете (входные данные / ожидаемые выходные данные / метаданные).

Перечисляет элементы набора данных.

Параметры

datasetNamestring
Filter by dataset name
limitinteger
Items per page (default 50, max 100)
pageinteger
Page number (default 1)
sourceObservationIdstring
sourceTraceIdstring

listDatasetRuns

Выводит список прогонов (раундов оценки) для набора данных.

Перечисляет запуски наборов данных.

Параметры

datasetNamestringобязательный
limitinteger
Items per page (default 50, max 100)
pageinteger
Page number (default 1)

listDatasets

Выводит список наборов данных, настроенных в Langfuse.

Перечисляет наборы данных.

Параметры

limitinteger
Items per page (default 50, max 100)
pageinteger
Page number (default 1)

listModels

Перечисляет модели, известные Langfuse (для учёта затрат/токенов).

Перечисляет модели.

Параметры

limitinteger
Items per page (default 50, max 100)
pageinteger
Page number (default 1)

listObservations

Перечисляет наблюдения (spans, generations, events) с фильтрами.

Перечисляет наблюдения

Параметры

environmentstring
fromStartTimestring
levelenum
limitinteger
Items per page (default 50, max 100)
namestring
pageinteger
Page number (default 1)
parentObservationIdstring
toStartTimestring
traceIdstring
typeenum
userIdstring

listProjects

Выводит список проектов, доступных по текущему API-ключу (как правило, один проект).

Выводит список проектов

Параметры

Без параметров.

listPrompts

Выводит список определений промптов, отслеживаемых в Langfuse.

Список промптов

Параметры

labelstring
Filter by label (e.g. 'production')
limitinteger
Items per page (default 50, max 100)
namestring
Filter by exact prompt name
pageinteger
Page number (default 1)
tagstring

listScoreConfigs

Перечисляет конфигурации оценок (определения названий оценок, диапазонов и категорий).

Перечисляет конфигурации оценок.

Параметры

limitinteger
Items per page (default 50, max 100)
pageinteger
Page number (default 1)

listScores

Выводит оценки с фильтрами.

Выводит список оценок

Параметры

fromTimestampstring
limitinteger
Items per page (default 50, max 100)
namestring
pageinteger
Page number (default 1)
toTimestampstring
traceIdstring
userIdstring

listSessions

Перечисляет сеансы в заданном временном диапазоне.

Перечисляет сеансы

Параметры

environmentstring
fromTimestampstring
ISO 8601 lower bound (inclusive)
limitinteger
Items per page (default 50, max 100)
pageinteger
Page number (default 1)
toTimestampstring
ISO 8601 upper bound (exclusive)

listTraces

Перечисляет трейсы Langfuse с фильтрами. Возвращает сводные метаданные (используйте getTrace для получения полного дерева наблюдений).

Перечисляет трассировки.

Параметры

environmentstring
fromTimestampstring
ISO 8601 lower bound (inclusive)
limitinteger
Items per page (default 50, max 100)
namestring
Exact trace name match
orderBystring
e.g. 'timestamp.desc' (default)
pageinteger
Page number (default 1)
sessionIdstring
tagsstring[]
toTimestampstring
ISO 8601 upper bound (exclusive)
userIdstring

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "langfuse-mcp"
  ],
  "env": {
    "LANGFUSE_PUBLIC_KEY": "pk-lf-…",
    "LANGFUSE_SECRET_KEY": "sk-lf-…",
    "LANGFUSE_BASE_URL": "https://cloud.langfuse.com"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 1
Форков на Github: 0
Загрузок: 4 263
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 09.09 в 01:29
Идентификатор: -fRL3o71G943k9x0
Категории: RAG-системы, Знания и память, ИИ и машинное обучение, Инструменты для разработчиков, Мониторинг, Наблюдаемость, Оркестрация агентов, Поиск