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

hugoles/langfuse-mcp

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

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

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

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.

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

getComment

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

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

Параметры

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

getDailyMetrics

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

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

Параметры

environmentstring
fromTimestampstring
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
pageinteger
Номер страницы, по умолчанию 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-запрос метрик (view, dimensions, metrics, filters, fromTimestamp, toTimestamp). См. документацию Langfuse.

getModel

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

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

Параметры

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

getObservation

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

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

Параметры

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

getPrompt

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

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

Параметры

labelstring
Конкретная метка для получения (например, 'production')
promptNamestringобязательный
versioninteger
Конкретная версия для получения (по умолчанию используется последняя production-версия)

getScore

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

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

Параметры

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

getScoreConfig

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

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

Параметры

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

getSession

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

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

Параметры

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

getTrace

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

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

Параметры

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

listComments

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

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

Параметры

authorUserIdstring
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
objectIdstring
objectTypeenum
Фильтрует по типу прикреплённого объекта.
pageinteger
Номер страницы, по умолчанию 1

listDatasetItems

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

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

Параметры

datasetNamestring
Фильтровать по имени набора данных.
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
pageinteger
Номер страницы, по умолчанию 1
sourceObservationIdstring
sourceTraceIdstring

listDatasetRuns

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

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

Параметры

datasetNamestringобязательный
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
pageinteger
Номер страницы, по умолчанию 1

listDatasets

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

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

Параметры

limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
pageinteger
Номер страницы, по умолчанию 1

listModels

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

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

Параметры

limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
pageinteger
Номер страницы, по умолчанию 1

listObservations

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

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

Параметры

environmentstring
fromStartTimestring
levelenum
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
namestring
pageinteger
Номер страницы, по умолчанию 1
parentObservationIdstring
toStartTimestring
traceIdstring
typeenum
userIdstring

listProjects

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

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

Параметры

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

listPrompts

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

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

Параметры

labelstring
Фильтрует по метке (например, 'production')
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
namestring
Фильтровать по точному имени запроса
pageinteger
Номер страницы, по умолчанию 1
tagstring

listScoreConfigs

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

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

Параметры

limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
pageinteger
Номер страницы, по умолчанию 1

listScores

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

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

Параметры

fromTimestampstring
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
namestring
pageinteger
Номер страницы, по умолчанию 1
toTimestampstring
traceIdstring
userIdstring

listSessions

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

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

Параметры

environmentstring
fromTimestampstring
Нижняя граница ISO 8601 (включительно)
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
pageinteger
Номер страницы, по умолчанию 1
toTimestampstring
ISO 8601 верхняя граница (не включительно)

listTraces

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

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

Параметры

environmentstring
fromTimestampstring
Нижняя граница ISO 8601 (включительно)
limitinteger
Элементов на странице (по умолчанию 20, максимум 50)
namestring
Точное совпадение имени трассировки
orderBystring
Например, 'timestamp.desc' (по умолчанию)
pageinteger
Номер страницы, по умолчанию 1
sessionIdstring
tagsstring[]
toTimestampstring
ISO 8601 верхняя граница (не включительно)
userIdstring

1.2.0основная

05.05.2026

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

Любой клиент

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

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

Cursor

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

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

VS Code

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

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

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

code --add-mcp "{\"name\":\"hugoles-langfuse-mcp-hq4i1i0zn0\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"langfuse-mcp\"],\"env\":{\"LANGFUSE_PUBLIC_KEY\":\"pk-lf-…\",\"LANGFUSE_SECRET_KEY\":\"sk-lf-…\",\"LANGFUSE_BASE_URL\":\"https://cloud.langfuse.com\"}}"

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": {
    "hugoles-langfuse-mcp-hq4i1i0zn0": {
      "command": "npx",
      "args": [
        "-y",
        "langfuse-mcp"
      ],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "pk-lf-…",
        "LANGFUSE_SECRET_KEY": "sk-lf-…",
        "LANGFUSE_BASE_URL": "https://cloud.langfuse.com"
      }
    }
  }
}

Claude Code

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

claude mcp add hugoles-langfuse-mcp-hq4i1i0zn0 --env LANGFUSE_PUBLIC_KEY=pk-lf-… --env LANGFUSE_SECRET_KEY=sk-lf-… --env LANGFUSE_BASE_URL=https://cloud.langfuse.com -- npx -y langfuse-mcp

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

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

Codex

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

codex mcp add hugoles-langfuse-mcp-hq4i1i0zn0 --env LANGFUSE_PUBLIC_KEY=pk-lf-… --env LANGFUSE_SECRET_KEY=sk-lf-… --env LANGFUSE_BASE_URL=https://cloud.langfuse.com -- npx -y langfuse-mcp

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

[mcp_servers.hugoles-langfuse-mcp-hq4i1i0zn0]
command = "npx"
args = ["-y", "langfuse-mcp"]

[mcp_servers.hugoles-langfuse-mcp-hq4i1i0zn0.env]
LANGFUSE_PUBLIC_KEY = "pk-lf-…"
LANGFUSE_SECRET_KEY = "sk-lf-…"
LANGFUSE_BASE_URL = "https://cloud.langfuse.com"

Perplexity

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

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

npx -y langfuse-mcp

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

Windsurf

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

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

Cline

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

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

Continue

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

mcpServers:
  - name: hugoles-langfuse-mcp-hq4i1i0zn0
    command: npx
    args:
      - "-y"
      - "langfuse-mcp"
    env:
      LANGFUSE_PUBLIC_KEY: pk-lf-…
      LANGFUSE_SECRET_KEY: sk-lf-…
      LANGFUSE_BASE_URL: https://cloud.langfuse.com

Zed

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

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

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

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