Сервер Logfire MCP

Этот репозиторий содержит сервер Model Context Protocol (MCP) с инструментами, которые могут получить доступ к трассировкам и метрикам OpenTelemetry, отправленным вами в Logfire.

Этот сервер MCP позволяет LLM извлекать данные телеметрии вашего приложения, анализировать распределенные трассировки и использовать результаты произвольных SQL-запросов, выполненных с использованием API Logfire.

Доступные инструменты

• find_exceptions — Получить количество исключений из трассировок, сгруппированных по файлу

  • Требуемые аргументы:

    • age (int): Количество минут для просмотра (например, 30 для последних 30 минут, максимум 7 дней)

• find_exceptions_in_file — получение подробной информации о трассировке исключений в определенном файле

  • Требуемые аргументы:

    • filepath (строка): Путь к файлу для анализа.

    • age (int): Количество минут, на которые нужно оглянуться назад (макс. 7 дней)

• arbitrary_query — выполнение пользовательских SQL-запросов по вашим трассировкам и метрикам OpenTelemetry

  • Требуемые аргументы:

    • query (строка): SQL-запрос для выполнения

    • age (int): Количество минут, на которые нужно оглянуться назад (макс. 7 дней)

• get_logfire_records_schema — получить схему OpenTelemetry для помощи с пользовательскими запросами

  • Нет требуемых аргументов

Related MCP server: MCP File Context Server

Настраивать

Установить uv

Первое, что нужно сделать, это убедиться, что установлен uv , так как uv используется для запуска сервера MCP.

Инструкции по установке см. в документации по установке .

Если у вас уже установлена старая версия uv , вам может потребоваться обновить ее с помощью uv self update .

Получите токен чтения Logfire

Для выполнения запросов к API Logfire серверу Logfire MCP требуется «токен чтения».

Вы можете создать его в разделе «Read Tokens» настроек вашего проекта в Logfire: https://logfire.pydantic.dev/-/redirect/latest-project/settings/read-tokens

[!ВАЖНО] Токены чтения Logfire специфичны для проекта, поэтому вам необходимо создать один для конкретного проекта, который вы хотите предоставить серверу Logfire MCP.

Запустите сервер вручную

После установки uv и получения токена чтения Logfire вы можете вручную запустить сервер MCP с помощью uvx (который предоставляется uv ).

Вы можете указать свой токен чтения с помощью переменной среды LOGFIRE_READ_TOKEN :

или с использованием флага --read-token :

[!ПРИМЕЧАНИЕ]
Если вы используете Cursor, Claude Desktop, Cline или другие клиенты MCP, которые управляют вашими серверами MCP для вас, вам НЕ нужно вручную запускать сервер самостоятельно. В следующем разделе будет показано, как настроить эти клиенты для использования сервера Logfire MCP.

Конфигурация с известными клиентами MCP

Настроить для курсора

Создайте файл .cursor/mcp.json в корневом каталоге вашего проекта:

Курсор не принимает поле env , поэтому вместо него необходимо использовать флаг --read-token .

Настройка для Claude Desktop

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

Настроить для Клайна

Добавьте к настройкам Cline в cline_mcp_settings.json :

Настройка - Базовый URL

По умолчанию сервер подключается к Logfire API по адресу https://logfire-api.pydantic.dev . Вы можете переопределить это следующим образом:

1. Использование аргумента --base-url :

2. Установка переменной среды:

Примеры взаимодействий

1. Найти все исключения в трассировках за последний час:

Ответ:

2. Получите подробную информацию об исключениях из трассировок в определенном файле:

Ответ:

3. Запустите пользовательский запрос по трассировкам:

Примеры вопросов для Клода

1. «Какие исключения произошли в трассировках за последний час по всем службам?»

2. «Покажите мне последние ошибки в файле 'app/api.py' с контекстом их трассировки»

3. «Сколько ошибок было за последние 24 часа в каждой службе?»

4. «Каковы наиболее распространенные типы исключений в моих трассировках, сгруппированные по имени службы?»

5. «Дайте мне схему OpenTelemetry для трассировок и метрик»

6. «Найти все ошибки за вчерашний день и показать их контексты трассировки»

Начиная

1. Сначала получите токен чтения Logfire по ссылке: https://logfire.pydantic.dev/-/redirect/latest-project/settings/read-tokens

2. Запустите сервер MCP:

   uvx logfire-mcp --read-token=YOUR_TOKEN

3. Настройте предпочитаемый вами клиент (Cursor, Claude Desktop или Cline), используя примеры конфигурации выше.

4. Начните использовать сервер MCP для анализа трассировок и метрик OpenTelemetry!

Внося вклад

Мы приветствуем вклады, которые помогут улучшить сервер Logfire MCP. Хотите ли вы добавить новые инструменты анализа трассировки, улучшить функциональность запросов метрик или улучшить документацию, ваш вклад будет ценным.

Примеры других серверов MCP и шаблонов реализации см. в репозитории серверов Model Context Protocol .

Лицензия

Logfire MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT.