Каталог MCP
hugoles
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.

getComment

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

Get a comment by id

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

Параметры

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

getDailyMetrics

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

Get daily metrics summary

Параметры

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

getDataset

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

Get a dataset by name

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

Параметры

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

getDatasetItem

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

Get a dataset item by id

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

Параметры

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

getDatasetRun

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

Get a dataset run

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

Параметры

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

getHealth

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

Check Langfuse API health

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

Параметры

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

getMedia

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

Get a media attachment metadata

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

Параметры

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

getMetrics

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

Query Langfuse metrics

Параметры

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

getModel

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

Get a model by id

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

Параметры

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

getObservation

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

Get observation by id

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

Параметры

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

getPrompt

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

Get a prompt (optionally a specific version or label)

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

Параметры

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

getScore

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

Get a single score by id

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

Параметры

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

getScoreConfig

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

Get a score configuration by id

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

Параметры

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

getSession

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

Get session with its traces

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

Параметры

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

getTrace

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

Get trace with full observation tree

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

Параметры

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

listComments

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

List comments

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

Параметры

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

listDatasetItems

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

List dataset items

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

Параметры

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

listDatasetRuns

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

List dataset runs

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

Параметры

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

listDatasets

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

List datasets

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

Параметры

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

listModels

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

List models

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

Параметры

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

listObservations

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

List observations

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

Параметры

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

listProjects

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

List projects

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

Параметры

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

listPrompts

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

List prompts

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

Параметры

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

listScoreConfigs

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

List score configurations

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

Параметры

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

listScores

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

List scores

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

Параметры

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

listSessions

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

List sessions

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

Параметры

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

listTraces

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

List traces

Параметры

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

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"
  }
}

Также hugoles/langfuse-mcp можно установить в Cursor по ссылке автоматически.

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

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

Другие проверенные MCP-сервера

mobile-next/mobile-mcp

MCP сервер для мобильной автоматизации iOS и Android на симуляторах, эмуляторах и реальных устройствах. Взаимодействует с приложениями через accessibility-деревья и скриншоты. Подходит для тестирования, data-entry, агентных систем и LLM-сценариев.

storybookjs/addon-mcp

официальный

MCP сервер для AI-агентов, интегрирующихся со Storybook: передаёт данные о UI-компонентах и упрощает процессы разработки. Полезен frontend-разработчикам и командам, использующим Storybook для документирования.

mrexodia/ida-pro-mcp

MCP сервер для реверс-инжиниринга в IDA Pro. Дает AI-ассистентам доступ к декомпиляции, просмотру типов и патчингу кода. Ускоряет анализ вредоносного ПО и отладку через интеграцию с популярными клиентами.

lharries/whatsapp-mcp

MCP-сервер для личного WhatsApp: читает сообщения (текст, медиа), ищет контакты, отправляет сообщения и файлы через Claude или Cursor. Подключается к вашему аккаунту через WhatsApp Web, всё хранится локально.

metorial/metorial

официальный

Metorial — open-source identity and access layer для AI-агентов. Он подключает агентов к реальным системам, обеспечивая единую аутентификацию, RBAC и полную наблюдаемость. Упрощает разработку и пов...

childrentime/reactuse

ReactUse — коллекция 100+ React хуков для браузера, состояния, элементов и эффектов. MCP сервер добавляет AI-поиск хуков, ускоряя создание приложений. Полезен для React-разработчиков.