Для чего этот сервер?

Этот MCP-сервер подключает агентов напрямую к Langfuse, чтобы они сами могли отлаживать сбои, искать медленные запросы и разбираться с ошибками в трейсах. Разработчику не нужно переключаться в дашборд — агент через MCP получает нужные данные о сессиях, исключениях и промптах прямо в рабочем процессе.

Что он умеет?

Сервер читает и фильтрует трейсы, отдельные наблюдения и сессии, показывает детали по пользователям. Ищет и разбирает исключения по файлам и функциям, считает ошибки за период. Находит и обобщает решения маршрутизации, включая низкоуверенные. Ведёт промпты: листает, получает с зависимостями или без, создаёт текстовые и чат-версии, обновляет метки. Работает с датасетами и их элементами, запусками, очередями аннотаций: создаёт, обновляет, удаляет. Запрашивает метрики по стоимости, задержкам и токенам, получает оценки.

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

avivsinai/langfuse-mcp

от avivsinai

Langfuse MCP Server - агентский интерфейс для Langfuse observability. Позволяет агентам запрашивать трейсы, отлаживать исключения, управлять промптами и датасетами, используя трассировку Langfuse д...

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

README

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

Версии

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

Langfuse MCP Server

Usage: 12,518 PyPI downloads last month (pypistats, 2026-08-19). v0.10.1.

Local MCP server and skill for Langfuse. Debug traces, sessions, and exceptions from Claude Code, Codex, Cursor, or any MCP client.

Why this instead of native Langfuse MCP?

Use this for local debug: first-class traces, sessions, and exceptions; route-decision tools; compact / file-dump output; plus the included langfuse skill.

Use official Langfuse MCP for hosted, zero-install access to the broader API (score writes, comments, models, media).

As of June 2026:

	langfuse-mcp	Native Langfuse MCP
Primary fit	Local debug: traces, sessions, exceptions	Hosted, zero-install API surface
Deployment	Local `stdio` or HTTP, via the Langfuse Python SDK	Native streamable HTTP at `/api/public/mcp`
Trace / session / exception tools	First-class	Observation/API-oriented access
Route-decision tools	Yes	No
Token & output control	Compact summaries, truncation, file-dump mode, tool-group gating	Hosted tool response + client
Metrics & dataset runs	Yes	Yes
Prompt, dataset, queue & score reads	Yes	Yes
Score writes, comments, models, media	No	Yes

Часто задаваемые вопросы

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

create_annotation_queue

Создаёт очередь аннотаций.

Параметры

descriptionstring | null
Описание очереди (необязательно)
namestringобязательный
Уникальное имя очереди
score_config_idsstring[] | null
Необязательные идентификаторы конфигурации оценки, прикреплённые к этой очереди.

create_annotation_queue_assignment

Назначить пользователя в очередь аннотации.

Параметры

queue_idstringобязательный
ID очереди аннотаций
user_idstringобязательный
User ID для назначения

create_annotation_queue_item

Создать элемент очереди аннотаций.

Параметры

object_idstringобязательный
ID объекта для постановки в очередь
object_typestringобязательный
Тип объекта, например TRACE или OBSERVATION
queue_idstringобязательный
ID очереди аннотаций
statusstring | null
Опциональный статус

create_chat_prompt

Создайте новую версию чат-промпта в Langfuse. Чат-промпты — это массивы сообщений с ролью/содержанием. Промпты неизменяемы; создайте новую версию, чтобы обновить содержимое. Метки уникальны для всех версий.

Параметры

commit_messagestring | null
Необязательное сообщение коммита, описывающее изменения.
configobject | null
Необязательная JSON-конфигурация (например, {model: 'gpt-4', temperature: 0.7})
labelsstring[] | null
Метки для назначения (например, ['production', 'staging'])
namestringобязательный
Имя создаваемого промпта.
promptobject[]обязательный
Сообщения чата в формате [{role: 'system'|'user'|'assistant', content: '...'}]
tagsstring[] | null
Необязательные теги для организации (например, ['experimental', 'v2'])

create_dataset

Создаёт новый набор данных в проекте. Наборы данных хранят тестовые сценарии оценки с парами «вход/ожидаемый выход». Параметры: ctx: Контекстный объект, содержащий контекст времени жизни вместе с клиентом Langfuse name: Имя нового набора данных (должно быть уникальным) description: Необязательное описание metadata: Необязательные пользовательские метаданные Возвращает: Словарь с подробностями созданного набора данных: - id: Уникальный идентификатор набора данных - name: Имя набора данных - description: Описание набора данных - metadata: Пользовательские метаданные - createdAt: Временная метка создания

Параметры

descriptionstring | null
Необязательное описание набора данных.
metadataobject | null
Необязательные пользовательские метаданные в виде пар ключ-значение.
namestringобязательный
Название для нового датасета (должно быть уникальным в проекте)

create_dataset_item

Создаёт новый элемент в наборе данных или обновляет существующий, если item_id уже есть. Элементы набора данных хранят пары «входные данные / ожидаемый результат» для оценки. Если item_id указан и уже существует, элемент будет обновлён (поведение upsert). Параметры: ctx: Контекстный объект с контекстом времени жизни, содержащим клиент Langfuse dataset_name: Имя целевого набора данных input: Входные данные для элемента expected_output: Ожидаемый результат для оценки metadata: Необязательные пользовательские метаданные source_trace_id: Необязательный идентификатор связанного трейса source_observation_id: Необязательный идентификатор связанного наблюдения item_id: Необязательный пользовательский идентификатор (включает upsert) status: Статус элемента (ACTIVE или ARCHIVED) Возвращает: Словарь с деталями созданного/обновлённого элемента

Параметры

dataset_namestringобязательный
Название набора данных, в который нужно добавить элемент
expected_outputany
Ожидаемые выходные данные для оценки (любое JSON-сериализуемое значение)
inputany
Входные данные для элемента набора данных (любое значение, сериализуемое в JSON).
item_idstring | null
Необязательный пользовательский ID элемента (для upsert)
metadataobject | null
Необязательные пользовательские метаданные в виде пар ключ-значение.
source_observation_idstring | null
Необязательный идентификатор наблюдения для привязки этого элемента.
source_trace_idstring | null
Необязательный ID трассировки для привязки этого элемента
statusenum | null
Статус элемента (по умолчанию: ACTIVE)

create_dataset_run_item

Создаёт элемент запуска датасета и сбрасывает запись ingestion.

Параметры

dataset_item_idstringобязательный
Идентификатор элемента набора данных для включения в запуск.
metadataobject | null
Необязательные метаданные элемента запуска.
observation_idstring | null
Необязательный ID наблюдения, связанный с этим элементом запуска.
run_descriptionstring | null
Описание запуска (необязательно)
run_namestringобязательный
Название запуска набора данных, к которому нужно добавить этот элемент
trace_idstring | null
Необязательный идентификатор трассировки, связанный с этим элементом запуска.

create_text_prompt

Создаёт новую версию текстового промпта в Langfuse. Промпты неизменяемы; единственный способ обновить содержимое промпта — создать новую версию. Метки уникальны между версиями: присвоение метки здесь переместит её с других версий.

Параметры

commit_messagestring | null
Необязательное сообщение коммита, описывающее изменения.
configobject | null
Необязательная JSON-конфигурация (например, {model: 'gpt-4', temperature: 0.7})
labelsstring[] | null
Метки для назначения (например, ['production', 'staging'])
namestringобязательный
Имя создаваемого промпта.
promptstringобязательный
Текст подсказки (поддерживает {{переменные}})
tagsstring[] | null
Необязательные теги для организации (например, ['experimental', 'v2'])

delete_annotation_queue_assignment

Открепить пользователя от очереди аннотаций.

Параметры

queue_idstringобязательный
ID очереди аннотаций
user_idstringобязательный
ID пользователя для отмены назначения

delete_annotation_queue_item

Удалить элемент очереди аннотаций.

Параметры

item_idstringобязательный
Идентификатор элемента очереди аннотаций
queue_idstringобязательный
ID очереди аннотаций

delete_dataset_item

Удаляет элемент датасета по ID. Это полное удаление, его нельзя отменить. Аргументы: ctx: Контекстный объект, содержащий контекст времени жизни с клиентом Langfuse item_id: ID элемента датасета для удаления Возвращает: Словарь, подтверждающий удаление

Параметры

item_idstringобязательный
ID элемента набора данных для удаления

delete_dataset_run

Удаляет запуск датасета по имени датасета и имени запуска.

Параметры

dataset_namestringобязательный
Имя набора данных, которому принадлежит запуск.
run_namestringобязательный
Название запуска набора данных, который нужно удалить.

fetch_observation

Получить одну запись по ID. Аргументы: ctx: объект Context, содержащий контекст времени жизни с клиентом Langfuse observation_id: ID записи для получения (строка уникального идентификатора) output_mode: управляет форматом вывода и степенью детализации Возвращаемое значение: В зависимости от output_mode: - compact: сжатый объект записи - full_json_string: строка, содержащая полный JSON-ответ - full_json_file: сжатый объект записи с информацией о сохранении в файл

Параметры

observation_idstringобязательный
ID наблюдения для получения (уникальная строка-идентификатор)
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.

fetch_observations

Получает наблюдения, отфильтрованные по типу и другим критериям. Аргументы: ctx: Объект контекста, содержащий lifespan context с клиентом Langfuse type: Тип наблюдения для фильтрации (SPAN, GENERATION или EVENT) age: Сколько минут назад начать поиск (например, 1440 для 24 часов) name: Необязательный фильтр по имени (шаблон строки для сопоставления) user_id: Необязательный фильтр по ID пользователя (точное совпадение) trace_id: Необязательный фильтр по ID трассировки (точное совпадение) parent_observation_id: Необязательный фильтр по ID родительского наблюдения (точное совпадение) page: Номер страницы для пагинации (начинается с 1) limit: Максимальное число наблюдений, возвращаемых на страницу output_mode: Управляет форматом вывода и уровнем детализации Возвращает: В зависимости от output_mode: - compact: Список объектов наблюдений в кратком виде - full_json_string: Строка, содержащая полный JSON-ответ - full_json_file: Список объектов наблюдений в кратком виде с информацией о сохранении в файл

Параметры

ageintegerобязательный
Минуты назад для начала поиска (например, 1440 для 24 часов)
limitinteger
Максимальное количество наблюдений для возврата на одной странице
namestring | null
Необязательный фильтр по имени (шаблон строки для сопоставления)
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
pageinteger
Номер страницы для пагинации (начинается с 1)
parent_observation_idstring | null
Необязательный фильтр по ID родительского наблюдения (точное совпадение)
trace_idstring | null
Необязательный фильтр по trace ID (точное совпадение)
typeenum | null
Тип наблюдения для фильтрации ('SPAN', 'GENERATION' или 'EVENT')
user_idstring | null
Необязательный фильтр по ID пользователя (точное совпадение)

fetch_sessions

Получить список сессий в текущем проекте. Аргументы: ctx: Объект Context, содержащий контекст времени жизни с клиентом Langfuse age: Сколько минут назад начинать поиск (например, 1440 (24 часа)) page: Номер страницы для пагинации (начинается с 1) limit: Максимальное количество сессий на страницу output_mode: Управляет форматом вывода и детализацией Возвращает: В зависимости от output_mode: - compact: Список кратких объектов сессий - full_json_string: Строка с полным JSON-ответом - full_json_file: Список кратких объектов сессий с информацией о сохранении в файл

Параметры

ageintegerобязательный
Минуты назад для начала поиска (например, 1440 для 24 часов)
limitinteger
Максимальное количество сеансов, возвращаемых на страницу
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
pageinteger
Номер страницы для пагинации (начинается с 1)

fetch_trace

Получает один трейс по ID со всеми деталями. Аргументы: ctx: Объект контекста, содержащий контекст времени жизни с клиентом Langfuse trace_id: ID трейса для получения (строка уникального идентификатора) include_observations: Если True, получает и включает полные объекты наблюдений. Если False, группа полей observations полностью отбрасывается, чтобы избежать дорогостоящего ввода-вывода по каждому наблюдению. Используйте True, когда нужен доступ к системным промптам, параметрам модели или другим деталям, хранящимся в наблюдениях. Значительно увеличивает время ответа, но даёт полные данные. output_mode: Управляет форматом вывода и уровнем детализации Возвращает: Один из следующих вариантов в зависимости от output_mode: - Для 'compact' и 'full_json_file': словарь ответа со структурой: { "data": Объект одного трейса, "metadata": { "file_path": Путь к сохранённому файлу (только для режима full_json_file), "file_info": Детали сохранения файла (только для режима full_json_file) } } - Для 'full_json_string': строка, содержащая полный JSON-ответ Советы по использованию: - Для быстрого просмотра: используйте include_observations=False с output_mode="compact" - Для полных данных, но с возможностью просмотра в ответах: используйте include_observations=True с output_mode="compact" - Для полных выгрузок данных: используйте include_observations=True с output_mode="full_json_file"

Параметры

include_observationsboolean
Если True, извлекает и включает полные объекты наблюдений. Если False, группа полей наблюдений полностью опускается, чтобы избежать дорогостоящего ввода-вывода на каждое наблюдение, который доминирует в больших трассировках. Используйте True, когда нужен доступ к системным промптам, параметрам модели или другим деталям, хранящимся в наблюдениях. Значительно увеличивает время ответа, но предоставляет полные данные. Хорошо сочетается с output_mode='full_json_file' для полных выгрузок.
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
trace_idstringобязательный
ID трассы для получения (строка уникального идентификатора)

fetch_traces

Находит трейсы по фильтрам. Все параметры фильтра необязательны.

Параметры

ageintegerобязательный
Минуты назад для начала поиска (например, 1440 для 24 часов)
include_observationsboolean
Если True, получает и включает полные объекты наблюдений вместо просто ID. Используйте это, когда вам нужен доступ к системным подсказкам, параметрам модели или другим деталям, хранящимся в наблюдениях. Значительно увеличивает время ответа, но предоставляет полные данные.
limitinteger
Максимальное количество трасс, возвращаемых на страницу
metadataobject | null
По каким полям метаданных фильтровать
namestring | null
Имя трассировки для фильтрации
output_modeenum
Управляет форматом вывода: «compact» (по умолчанию) возвращает сводный JSON, «full_json_string» возвращает полный сырой JSON в виде строки, «full_json_file» сохраняет полные данные в файл и возвращает сводку с указанием пути.
pageinteger
Номер страницы для пагинации (начинается с 1)
session_idstring | null
Идентификатор сеанса для фильтрации трассировок
tagsstring | null
Тег или список тегов через запятую для фильтрации трейсов
user_idstring | null
ID пользователя для фильтрации трассировок

find_exceptions

Получает счётчики исключений, сгруппированные по пути к файлу, функции или типу. Аргументы: ctx: Объект контекста, содержащий контекст жизненного цикла с клиентом Langfuse age: Количество минут назад для поиска; ограничено заданным максимумом group_by: Как группировать исключения - "file" группирует по имени файла, "function" группирует по имени функции, или "type" группирует по типу исключения Возвращает: Список счётчиков исключений, сгруппированных по указанной категории (file, function или type)

Параметры

ageintegerобязательный
Количество минут для просмотра назад (положительное целое число, максимум 7 дней/10080 минут)
group_byenum
Как группировать исключения: 'file' группирует по имени файла, 'function' группирует по имени функции, или 'type' группирует по типу исключения.

find_exceptions_in_file

Получает подробную информацию об исключении для конкретного файла. Аргументы: ctx: объект Context, содержащий контекст жизненного цикла с клиентом Langfuse filepath: путь к файлу для поиска исключений (полный путь с расширением) age: на сколько минут назад искать; ограничено настроенным максимумом output_mode: управляет форматом вывода и уровнем детализации Возвращает: В зависимости от output_mode: - compact: список кратких сведений об исключениях - full_json_string: строка, содержащая полный JSON-ответ - full_json_file: список кратких сведений об исключениях с информацией о сохранении файла

Параметры

ageintegerобязательный
Количество минут для просмотра назад (положительное целое число, максимум 7 дней/10080 минут)
filepathstringобязательный
Путь к файлу для поиска исключений (полный путь, включая расширение)
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.

find_low_confidence_route_decisions

Найди решения маршрутов с низкой уверенностью или явно невызываемые.

Параметры

ageinteger
Количество минут для просмотра назад (положительное целое число, максимум 7 дней/10080 минут)
capability_idstring | null
Необязательный фильтр по capability_id в метаданных решения о маршруте.
include_uncallableboolean
Также возвращает решения с метаданными callable=false
limitinteger
Максимальное количество совпадающих решений о маршрутизации для возврата
max_confidencenumber
Возвращает решения о маршруте с уверенностью на уровне этого значения или ниже.
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
pageinteger
Номер страницы для пагинации (начинается с 1)
providerstring | null
Необязательный фильтр провайдера метаданных маршрутных решений.
router_namestring | null
Необязательный фильтр метаданных решения о маршрутизации по router_name.
session_idstring | null
Необязательный фильтр по session_id в метаданных решения о маршруте.
trace_idstring | null
Необязательный фильтр по trace ID Langfuse

find_route_decisions

Находит решения о маршрутизации агентов общего назначения, эмитированные как наблюдения SPAN в Langfuse. Этот инструмент не зависит от маршрутизатора. Он считает решениями о маршрутизации только те наблюдения, у которых metadata.schema_version == "mcp.route_decision.v1", и фильтрует по полям внутри метаданных наблюдения, а не по отображаемым данным.

Параметры

ageinteger
Количество минут для просмотра назад (положительное целое число, максимум 7 дней/10080 минут)
capability_idstring | null
Необязательный фильтр по capability_id в метаданных решения о маршруте.
decision_idstring | null
Необязательный фильтр decision_id в метаданных решения маршрута.
limitinteger
Максимальное количество решений о маршруте на страницу
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
pageinteger
Номер страницы для пагинации (начинается с 1)
providerstring | null
Необязательный фильтр провайдера метаданных маршрутных решений.
router_namestring | null
Необязательный фильтр метаданных решения о маршрутизации по router_name.
session_idstring | null
Необязательный фильтр по session_id в метаданных решения о маршруте.
trace_idstring | null
Необязательный фильтр по trace ID Langfuse

get_annotation_queue

Получить одну очередь аннотаций по ID.

Параметры

queue_idstringобязательный
ID очереди аннотаций

get_annotation_queue_item

Получить конкретный элемент очереди аннотаций по ID очереди и ID элемента.

Параметры

item_idstringобязательный
Идентификатор элемента очереди аннотаций
queue_idstringобязательный
ID очереди аннотаций

get_data_schema

Получить схему объектов trace, span и event. Аргументы: ctx: Context-объект, содержащий контекст жизненного цикла с клиентом Langfuse dummy: Неиспользуемый параметр для совместимости API (можно оставить пустым) Возвращает: Строку с подробным описанием схемы для traces, spans, events и других базовых структур данных Langfuse

Параметры

dummystring

get_dataset

Получить конкретный набор данных по имени. Извлекает детали набора данных, включая метаданные и количество элементов. Аргументы: ctx: Объект контекста, содержащий контекст времени жизни с клиентом Langfuse name: Имя набора данных для получения Возвращает: Словарь с деталями набора данных: - id: Уникальный идентификатор набора данных - name: Имя набора данных - description: Описание набора данных - metadata: Пользовательские метаданные - items: Список элементов набора данных (если включены API) - runs: Список прогонов набора данных (если включены API)

Параметры

namestringобязательный
Название набора данных для получения.

get_dataset_item

Получить конкретный элемент датасета по ID. Возвращает полную запись элемента датасета: входные данные, ожидаемый выход, метаданные и связанные трейсы. Аргументы: ctx: Контекстный объект, содержащий lifespan context с клиентом Langfuse item_id: ID элемента датасета для загрузки output_mode: Формат ответных данных Возвращает: Словарь с деталями элемента датасета: - id: Уникальный идентификатор элемента - datasetId: ID родительского датасета - input: Входные данные - expectedOutput: Ожидаемый выход - metadata: Пользовательские метаданные - sourceTraceId: ID связанного трейса (если есть) - sourceObservationId: ID связанного наблюдения (если есть) - status: Статус элемента (ACTIVE или ARCHIVED)

Параметры

item_idstringобязательный
Идентификатор элемента набора данных для получения.
output_modeenum
Формат вывода: 'compact' усекает, 'full_json_string' возвращает полные данные, 'full_json_file' записывает в файл.

get_dataset_run

Получить запуск набора данных, включая все элементы запуска, возвращённые SDK.

Параметры

dataset_namestringобязательный
Имя набора данных, которому принадлежит запуск.
output_modeenum
Формат вывода: 'compact' усекает, 'full_json_string' возвращает полные данные, 'full_json_file' записывает в файл.
run_namestringобязательный
Название запуска набора данных для получения

get_error_count

Получает количество трассировок с исключениями за последние N минут. Аргументы: ctx: объект Context, содержащий контекст lifespan с клиентом Langfuse age: количество минут для поиска назад; ограничено настроенным максимумом Возвращает: Словарь со статистикой ошибок, включая количество трассировок, количество наблюдений и количество исключений

Параметры

ageintegerобязательный
Количество минут для просмотра назад (положительное целое число, максимум 7 дней/10080 минут)

get_exception_details

Получает подробную информацию об исключениях для трейса/спана. Аргументы: ctx: объект Context, содержащий контекст жизненного цикла с клиентом Langfuse trace_id: ID трейса для анализа исключений (строка уникального идентификатора) span_id: Необязательный ID спана для фильтрации по конкретному спану (строка уникального идентификатора) output_mode: Управляет форматом вывода и уровнем детализации Возвращает: В зависимости от output_mode: - compact: список сводных сведений об исключениях - full_json_string: строка, содержащая полный JSON-ответ - full_json_file: список сводных сведений об исключениях с информацией о сохранении в файл

Параметры

output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
span_idstring | null
Необязательный идентификатор span для фильтрации по конкретному span (строка уникального идентификатора).
trace_idstringобязательный
Идентификатор трассировки для анализа исключений (уникальная строка идентификатора)

get_metrics_schema

Получить схему запросов для metrics API (представления, измерения, показатели, агрегации). Сопутствующий инструмент для query_metrics: описывает, какие представления существуют, какие измерения и показатели доступны для каждого, поддерживаемые агрегации/операторы и форму query-объекта. dummy не используется и существует только для совместимости с MCP API.

Параметры

dummystring

get_prompt

Получает конкретный промпт по имени с разрешёнными зависимостями. Извлекает промпт из Langfuse со всеми разрешёнными тегами зависимостей. Использует встроенное кэширование SDK для оптимальной производительности. Аргументы: ctx: объект Context, содержащий контекст времени жизни с клиентом Langfuse name: имя промпта для получения label: опциональная метка для получения (например, 'production'). Нельзя использовать вместе с version. version: опциональный номер версии. Нельзя использовать вместе с label. Возвращает: Словарь с деталями промпта: - id: уникальный идентификатор промпта - name: имя промпта - version: номер версии - type: 'text' или 'chat' - prompt: содержимое промпта (строка для text, список для chat) - labels: список меток, назначенных этой версии - tags: список тегов - config: конфигурация модели (temperature, model и т.д.) Вызывает исключения: ValueError: если указаны и label, и version LookupError: если промпт не найден

Параметры

labelstring | null
Метка для получения (например, 'production', 'staging'). Взаимоисключающая с версией.
namestringобязательный
Имя запроса для получения
versioninteger | null
Конкретный номер версии для получения. Взаимоисключающ с меткой.

get_prompt_unresolved

Получает конкретный prompt по имени БЕЗ разрешения зависимостей. Возвращает исходное содержимое prompt с нетронутыми тегами зависимостей (например, @@@langfusePrompt:name=xxx@@@), если SDK поддерживает resolve=false. В противном случае возвращает разрешённый prompt и помечает metadata.resolved=True. Полезен для анализа состава prompt и отладки цепочек зависимостей. Args: ctx: Объект Context, содержащий жизненный контекст с клиентом Langfuse name: Имя prompt'а для получения label: Необязательная метка для получения. Нельзя использовать вместе с version. version: Необязательный номер версии. Нельзя использовать вместе с label. Returns: Словарь, содержащий необработанные детали prompt с сохранёнными тегами зависимостей. Raises: ValueError: если указаны и label, и version LookupError: если prompt не найден

Параметры

labelstring | null
Метка для получения (например, 'production', 'staging'). Взаимоисключающая с версией.
namestringобязательный
Имя запроса для получения
versioninteger | null
Конкретный номер версии для получения. Взаимоисключающ с меткой.

get_route_decision

Получить одно решение маршрута по метаданным decision_id.

Параметры

ageinteger
Количество минут для просмотра назад (положительное целое число, максимум 7 дней/10080 минут)
decision_idstringобязательный
Метаданные решения о маршруте: decision_id для получения.
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.

get_score_v2

Получает оценку по ID из API scores (v3 score_v_2 или v4 scores).

Параметры

score_idstringобязательный
ID оценки

get_session_details

Получить подробную информацию о конкретной сессии. Аргументы: ctx: объект Context, содержащий контекст времени жизни с клиентом Langfuse session_id: идентификатор сессии для получения (строка уникального идентификатора) include_observations: если True, получает и включает полные объекты наблюдений вместо простых идентификаторов. Используйте это, когда вам нужен доступ к системным промптам, параметрам модели или другим деталям, хранящимся в наблюдениях. Значительно увеличивает время ответа, но предоставляет полные данные. output_mode: управляет форматом вывода и уровнем детализации Возвращает: В зависимости от output_mode: - compact: объект с краткой информацией о сессии - full_json_string: строка, содержащая полный JSON ответ - full_json_file: объект с краткой информацией о сессии и информацией о сохранении файла Советы по использованию: - Для быстрого просмотра: используйте include_observations=False с output_mode="compact" - Для полных данных, но доступных в ответе: используйте include_observations=True с output_mode="compact" - Для полного дампа данных: используйте include_observations=True с output_mode="full_json_file"

Параметры

include_observationsboolean
Если значение равно True, получает и включает полные объекты наблюдений вместо только идентификаторов. Используйте это, когда нужен доступ к системным подсказкам, параметрам модели или другим данным, хранящимся в объектах наблюдений. Это заметно увеличивает время ответа, но предоставляет полные данные. Хорошо сочетается с параметром output_mode='full_json_file' для полных выгрузок.
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
session_idstringобязательный
Идентификатор сеанса для получения (уникальная строка идентификатора)

get_user_sessions

Получает сессии пользователя за заданный временной промежуток. Аргументы: ctx: объект контекста, содержащий контекст времени жизни с клиентом Langfuse user_id: идентификатор пользователя, для которого нужно получить сессии (уникальная строка) age: сколько минут назад начинать поиск (например, 1440 для 24 часов) include_observations: если True, получать и включать полные объекты наблюдений вместо только ID. Используйте, когда нужен доступ к системным промптам, параметрам модели или другим деталям, хранящимся в наблюдениях. Значительно увеличивает время ответа, но даёт полные данные. output_mode: управляет форматом и детализацией вывода Возвращает: В зависимости от output_mode: - compact: список сводных объектов сессий - full_json_string: строка с полным JSON-ответом - full_json_file: список сводных объектов сессий с информацией о сохранении в файл Советы по использованию: - Для быстрого просмотра: используйте include_observations=False с output_mode="compact" - Для полных данных, но доступных для просмотра в ответах: используйте include_observations=True с output_mode="compact" - Для выгрузки полных данных: используйте include_observations=True с output_mode="full_json_file"

Параметры

ageintegerобязательный
Минуты назад для начала поиска (например, 1440 для 24 часов)
include_observationsboolean
Если значение равно True, получает и включает полные объекты наблюдений вместо только идентификаторов. Используйте это, когда нужен доступ к системным подсказкам, параметрам модели или другим данным, хранящимся в объектах наблюдений. Это заметно увеличивает время ответа, но предоставляет полные данные. Хорошо сочетается с параметром output_mode='full_json_file' для полных выгрузок.
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
user_idstringобязательный
ID пользователя, для которого нужно получить сессии

list_annotation_queue_items

Вывести список элементов в очереди аннотаций.

Параметры

limitinteger
Элементов на странице (макс. 100)
pageinteger
Номер страницы для пагинации (начинается с 1)
queue_idstringобязательный
ID очереди аннотаций

list_annotation_queues

Список очередей аннотации с пагинацией.

Параметры

limitinteger
Элементов на странице (макс. 100)
pageinteger
Номер страницы для пагинации (начинается с 1)

list_dataset_items

Выводит список элементов датасета с постраничной разбивкой и опциональной фильтрацией. Возвращает элементы датасета: входные данные, ожидаемый результат и метаданные. Аргументы: ctx: объект Context, содержащий контекст времени жизни с клиентом Langfuse dataset_name: имя датасета, из которого нужно вывести элементы source_trace_id: опциональный фильтр по идентификатору исходного трейса source_observation_id: опциональный фильтр по идентификатору исходного наблюдения page: номер страницы для постраничной навигации (начиная с 1) limit: максимальное количество элементов на странице (не более 100) output_mode: способ форматирования ответных данных Возвращает: Словарь, содержащий: - data: список объектов элементов датасета - metadata: информация о постраничной навигации (page, limit, total, dataset_name)

Параметры

dataset_namestringобязательный
Название набора данных, из которого нужно перечислить элементы
limitinteger
Элементов на странице (макс. 100)
output_modeenum
Формат вывода: 'compact' усекает, 'full_json_string' возвращает полные данные, 'full_json_file' записывает в файл.
pageinteger
Номер страницы для пагинации (начинается с 1)
source_observation_idstring | null
Фильтровать по ID исходного наблюдения
source_trace_idstring | null
Фильтровать по ID исходной трассировки

list_dataset_run_items

Вывести список элементов запуска набора данных по идентификатору набора данных и имени запуска.

Параметры

dataset_idstringобязательный
ID набора данных, которому принадлежат элементы запуска
limitinteger
Элементов на странице (макс. 100)
output_modeenum
Формат вывода: 'compact' усекает, 'full_json_string' возвращает полные данные, 'full_json_file' записывает в файл.
pageinteger
Номер страницы для пагинации (начинается с 1)
run_namestringобязательный
Название запуска набора данных для вывода элементов

list_dataset_runs

Выводит список запусков для датасета по его имени.

Параметры

dataset_namestringобязательный
Имя набора данных, из которого перечисляются запуски.
limitinteger
Элементов на странице (макс. 100)
pageinteger
Номер страницы для пагинации (начинается с 1)

list_datasets

Вывести все датасеты в проекте с пагинацией. Возвращает метаданные о датасетах: название, описание, количество элементов и временные метки. Аргументы: ctx: Контекстный объект, содержащий контекст жизненного цикла с клиентом Langfuse page: Номер страницы для пагинации (начиная с 1) limit: Максимальное количество элементов на странице (не более 100) Возвращает: Словарь, содержащий: - data: Список объектов метаданных датасетов - metadata: Информация о пагинации (page, limit, total)

Параметры

limitinteger
Элементов на странице (макс. 100)
pageinteger
Номер страницы для пагинации (начинается с 1)

list_prompts

Список и фильтрация промптов в проекте. Возвращает метаданные промптов: версии, метки, теги и время последнего обновления. Аргументы: ctx: Контекстный объект с lifespan context и клиентом Langfuse name: Опциональный фильтр по точному имени промпта label: Опциональный фильтр по метке для любой версии tag: Опциональный фильтр по тегу page: Номер страницы для пагинации (начиная с 1) limit: Максимум элементов на странице (макс. 100) Возвращает: Словарь, содержащий: - data: Список объектов метаданных промптов - metadata: Информация о пагинации (page, limit, total)

Параметры

labelstring | null
Фильтровать по метке (например, 'production', 'staging')
limitinteger
Элементов на странице (макс. 100)
namestring | null
Фильтровать по точному имени запроса
pageinteger
Номер страницы для пагинации (начинается с 1)
tagstring | null
Фильтр по тегу

list_scores_v2

Выводит список оценок из API score v2 с необязательными фильтрами.

Параметры

config_idstring | null
Необязательный ID конфигурации оценки
data_typestring | null
Опциональный тип данных для оценки
environmentstring | null
Необязательный фильтр окружения
from_timestampstring | null
Необязательная нижняя граница временной метки ISO8601.
limitinteger
Элементов на странице (макс. 100)
namestring | null
Необязательный фильтр по имени оценки.
operatorstring | null
Необязательный фильтр оператора
pageinteger
Номер страницы для пагинации (начинается с 1)
queue_idstring | null
Необязательный ID очереди аннотаций
score_idsstring | null
Необязательные ID оценок через запятую.
session_idstring | null
Необязательный идентификатор сеанса
sourcestring | null
Необязательный фильтр источника оценки.
to_timestampstring | null
Необязательная верхняя граница временной метки ISO8601
trace_idstring | null
Необязательный trace ID
trace_tagsstring | null
Необязательные теги трассировки через запятую
user_idstring | null
Необязательный фильтр по ID пользователя
valuenumber | null
Необязательный фильтр по числовому значению оценки.

query_metrics

Запрашивает агрегированные метрики (стоимость, задержка, использование токенов, количество, значения оценок) из Langfuse. Обёртка над эндпоинтом метрик Langfuse v2. Используйте для аналитических запросов — «сколько стоила инференция за последние 24 часа в разрезе моделей», «p95 задержка на промпт», «распределение оценок по названиям» — вместо того, чтобы выгружать сырые наблюдения и агрегировать на стороне клиента. Контракты по каждому параметру описаны в описаниях полей выше. Примечания: - Эндпоинт метрик v2 доступен только в Langfuse Cloud; самостоятельные инстансы могут вернуть 404. - Недавно добавленные данные могут задерживаться (задержка приёма OTEL до ~10 минут). - Поля с высокой кардинальностью (id, traceId, userId, sessionId) должны быть фильтрами, а не измерениями.

Параметры

ageinteger | null
Минуты для просмотра назад от текущего момента (например, 1440 для 24 часов). Используется, когда from_timestamp опущен; по умолчанию 1440 (24 часа), если временной диапазон не указан.
dimensionsstring[] | null
Необязательные поля для группировки результатов, например ['providedModelName']. НЕ используйте поля с высокой кардинальностью (id, traceId, userId, sessionId) как измерения — передавайте их как фильтры.
filtersobject[] | null
Необязательные объекты фильтров: {'column','operator','value','type', плюс 'key' для метаданных/типов объектов}. Пример: [{'column':'userId','operator':'=','value':'u1','type':'string'}]. Смотрите get_metrics_schema для операторов и типов.
from_timestampstring | null
Начало временного диапазона в формате ISO-8601. Переопределяет 'age', когда указано.
metricsobject[]обязательный
Одна или несколько метрик для вычисления. Каждый элемент — это {'measure': <name>, 'aggregation': <fn>}, например [{'measure': 'totalCost', 'aggregation': 'sum'}, {'measure': 'latency', 'aggregation': 'p95'}]. Агрегации: sum, avg, count, max, min, p50, p75, p90, p95, p99, histogram.
order_byobject[] | null
Необязательная сортировка: список из {'field': <измерение-или-метрика>, 'direction': 'asc'|'desc'}.
output_modeenum
Управляет форматом вывода и действием. 'compact' (по умолчанию): возвращает сжатый JSON-объект, оптимизированный для прямого использования агентом. 'full_json_string': возвращает полные необработанные JSON-данные в виде строки. 'full_json_file': возвращает сжатый JSON-объект и сохраняет полные данные в файл.
time_granularityenum | null
Когда этот параметр задан, результаты группируются по указанной гранулярности в пределах временного диапазона (временной ряд).
to_timestampstring | null
Конец временного диапазона в формате ISO-8601. По умолчанию используется текущее время (UTC).
viewenumобязательный
Представление данных для агрегации: 'observations' (спаны/генерации/события — задержка, стоимость, токены, количество), 'scores-numeric' (числовые/булевы оценки) или 'scores-categorical' (категориальные оценки). Вызовите get_metrics_schema для получения полного каталога измерений и метрик для каждого представления.

summarize_route_decisions

Обобщает общие решения маршрутизации для трассировки, сессии, маршрутизатора, провайдера или возможности.

Параметры

ageinteger
Количество минут для просмотра назад (положительное целое число, максимум 7 дней/10080 минут)
capability_idstring | null
Необязательный фильтр по capability_id в метаданных решения о маршруте.
limitinteger
Максимальное количество решений о маршрутизации для сводки с текущей страницы.
max_confidencenumber
Порог уверенности, используемый для подсчетов с низкой уверенностью.
pageinteger
Номер страницы для пагинации (начинается с 1)
providerstring | null
Необязательный фильтр провайдера метаданных маршрутных решений.
router_namestring | null
Необязательный фильтр метаданных решения о маршрутизации по router_name.
session_idstring | null
Необязательный фильтр по session_id в метаданных решения о маршруте.
trace_idstring | null
Необязательный фильтр по trace ID Langfuse

update_annotation_queue_item

Обновляет статус элемента очереди аннотаций.

Параметры

item_idstringобязательный
Идентификатор элемента очереди аннотаций
queue_idstringобязательный
ID очереди аннотаций
statusstringобязательный
Новое значение статуса

update_prompt_labels

Обновить метки для конкретной версии промпта. Это единственная поддерживаемая мутация для существующих промптов. Предоставленные метки добавляются к версии (существующие метки сохраняются). Метки уникальны для всех версий, а метка 'latest' управляется Langfuse.

Параметры

labelsstring[]обязательный
Метки для добавления к этой версии (может быть пустым, чтобы ничего не добавлять). Существующие метки сохраняются; метки уникальны для всех версий.
namestringобязательный
Имя промпта для обновления
versionintegerобязательный
Версия промпта для обновления

`0.13.0`основная	11.10.2026
`0.12.1`	25.09.2026
`0.12.0`	25.09.2026
`0.11.0`	10.09.2026
`0.10.2`	09.09.2026
`0.10.1`	06.08.2026
`0.10.0`	27.06.2026
`0.9.1`	06.05.2026
`0.9.0`	29.04.2026
`0.8.0`	28.04.2026
`0.7.0`	26.04.2026
`0.6.5`	03.04.2026
`0.6.4`	01.04.2026
`0.6.3`	01.04.2026
`0.5.3`	29.03.2026
`0.5.2`	08.02.2026
`0.5.1`	27.01.2026
`0.5.0`	23.01.2026
`0.4.2`	19.01.2026
`0.4.1`	19.01.2026
`0.4.0`	19.01.2026
`0.3.4`	13.01.2026
`0.3.3`	13.01.2026
`0.3.2`	13.01.2026
`0.3.1`	07.01.2026
`0.3.0`	06.01.2026
`0.2.1`	20.10.2025
`0.2.0`	02.10.2025
`0.1.8`	05.06.2025
`0.1.7`	05.06.2025
`0.1.6`	01.04.2025

Выберите клиент, чтобы установить avivsinai/langfuse-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "avivsinai-langfuse-mcp-xpvypr5bsg": {
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-...",
        "LANGFUSE_SECRET_KEY": "sk-...",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "avivsinai-langfuse-mcp-xpvypr5bsg": {
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-...",
        "LANGFUSE_SECRET_KEY": "sk-...",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "avivsinai-langfuse-mcp-xpvypr5bsg": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-...",
        "LANGFUSE_SECRET_KEY": "sk-...",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"avivsinai-langfuse-mcp-xpvypr5bsg\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"langfuse-mcp\"],\"env\":{\"LANGFUSE_PUBLIC_KEY\":\"pk-...\",\"LANGFUSE_SECRET_KEY\":\"sk-...\",\"LANGFUSE_HOST\":\"https://cloud.langfuse.com\",\"LANGFUSE_MCP_DEFAULT_OUTPUT_MODE\":\"full_json_file\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "avivsinai-langfuse-mcp-xpvypr5bsg": {
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-...",
        "LANGFUSE_SECRET_KEY": "sk-...",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add avivsinai-langfuse-mcp-xpvypr5bsg --env LANGFUSE_PUBLIC_KEY=pk-... --env LANGFUSE_SECRET_KEY=sk-... --env LANGFUSE_HOST=https://cloud.langfuse.com --env LANGFUSE_MCP_DEFAULT_OUTPUT_MODE=full_json_file -- uvx langfuse-mcp

Либо через JSON-конфиг:

claude mcp add-json avivsinai-langfuse-mcp-xpvypr5bsg "{\"command\":\"uvx\",\"args\":[\"langfuse-mcp\"],\"env\":{\"LANGFUSE_PUBLIC_KEY\":\"pk-...\",\"LANGFUSE_SECRET_KEY\":\"sk-...\",\"LANGFUSE_HOST\":\"https://cloud.langfuse.com\",\"LANGFUSE_MCP_DEFAULT_OUTPUT_MODE\":\"full_json_file\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add avivsinai-langfuse-mcp-xpvypr5bsg --env LANGFUSE_PUBLIC_KEY=pk-... --env LANGFUSE_SECRET_KEY=sk-... --env LANGFUSE_HOST=https://cloud.langfuse.com --env LANGFUSE_MCP_DEFAULT_OUTPUT_MODE=full_json_file -- uvx langfuse-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.avivsinai-langfuse-mcp-xpvypr5bsg]
command = "uvx"
args = ["langfuse-mcp"]

[mcp_servers.avivsinai-langfuse-mcp-xpvypr5bsg.env]
LANGFUSE_PUBLIC_KEY = "pk-..."
LANGFUSE_SECRET_KEY = "sk-..."
LANGFUSE_HOST = "https://cloud.langfuse.com"
LANGFUSE_MCP_DEFAULT_OUTPUT_MODE = "full_json_file"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите avivsinai/langfuse-mcp, а в поле команды запуска — строку ниже:

uvx langfuse-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "avivsinai-langfuse-mcp-xpvypr5bsg": {
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-...",
        "LANGFUSE_SECRET_KEY": "sk-...",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "avivsinai-langfuse-mcp-xpvypr5bsg": {
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-...",
        "LANGFUSE_SECRET_KEY": "sk-...",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например avivsinai-langfuse-mcp-xpvypr5bsg.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: avivsinai-langfuse-mcp-xpvypr5bsg
    command: uvx
    args:
      - "langfuse-mcp"
    env:
      LANGFUSE_PUBLIC_KEY: pk-...
      LANGFUSE_SECRET_KEY: sk-...
      LANGFUSE_HOST: https://cloud.langfuse.com
      LANGFUSE_MCP_DEFAULT_OUTPUT_MODE: full_json_file

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "avivsinai-langfuse-mcp-xpvypr5bsg": {
      "command": "uvx",
      "args": [
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-...",
        "LANGFUSE_SECRET_KEY": "sk-...",
        "LANGFUSE_HOST": "https://cloud.langfuse.com",
        "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
      }
    }
  }
}

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

{
  "command": "uvx",
  "args": [
    "langfuse-mcp"
  ],
  "env": {
    "LANGFUSE_PUBLIC_KEY": "pk-...",
    "LANGFUSE_SECRET_KEY": "sk-...",
    "LANGFUSE_HOST": "https://cloud.langfuse.com",
    "LANGFUSE_MCP_DEFAULT_OUTPUT_MODE": "full_json_file"
  }
}

Нужен uvx

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

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

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

Номер в рейтинге: #176
Звезд на Github: 113
Форков на Github: 29
Загрузок: 63 117
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 10:25
Идентификатор: 1DfgMJSCpOpi3pqr
Категории: ИИ и машинное обучение, Инструменты для разработчиков, Мониторинг