Honeybadger MCP Server

Руководство по настройке сервера Honeybadger MCP

Этот сервер MCP интегрирует отслеживание ошибок Honeybadger с Cursor IDE, позволяя вам извлекать и анализировать ошибки непосредственно из среды разработки.

Предпосылки

• Node.js 18+ установлен
• Аккаунт Honeybadger с доступом к API
• Курсор IDE с поддержкой MCP

Установка

1. Клонируйте MCP-сервер

2. Создайте проект

3. Использование в качестве пакета NPM (рекомендуется)

Глобальная установка:

Затем настройте его в курсоре:

Проектная установка (альтернативная):

Если вы предпочитаете управлять сервером MCP как зависимостью проекта:

В этом случае команда в вашем курсоре mcp_servers.json будет указывать на локальную установку в node_modules вашего проекта:

4. Настройте переменные среды

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

4. Получите удостоверение Honeybadger

1. API-ключ :
   • Перейдите по ссылке https://app.honeybadger.io/users/auth\_tokens
   • Создайте новый персональный токен аутентификации
   • Скопируйте токен для вашего файла .env
2. Идентификатор проекта :
   • Перейдите к своему проекту в Honeybadger
   • Идентификатор проекта находится в URL: https://app.honeybadger.io/projects/{PROJECT_ID}
   • Или найдите его в настройках проекта

Конфигурация курсора

1. Настройте MCP в курсоре

Добавьте сервер MCP в конфигурацию вашего курсора. Отредактируйте ваш ~/.cursor/mcp_servers.json (или эквивалент):

2. Альтернатива: глобальная установка

Этот раздел будет обновлен или удален, так как теперь он описан выше. Если вы предпочитаете старый способ клонирования и установки глобально из локального пути, вы все равно можете это сделать, но использование опубликованного пакета npm рекомендуется для более простых обновлений и управления.

При установке с локального клона:

Использование

После настройки вы сможете использовать следующие инструменты в Cursor:

1. Перечислите недавние неисправности

2. Получите подробную информацию о неисправности

3. Проанализируйте проблему

4. Получить сведения о возникновении ошибок

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

list_honeybadger_faults

Перечисляет последние неисправности с возможностью фильтрации по среде и статусу устранения.

Параметры:

• project_id (необязательно): идентификатор проекта
• limit (необязательно): количество ошибок (по умолчанию: 20, макс: 100)
• environment (необязательно): Фильтр по среде
• resolved (необязательно): Фильтр по статусу решено

get_honeybadger_fault

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

Параметры:

• fault_id (обязательно): идентификатор неисправности
• project_id (необязательно): идентификатор проекта

get_honeybadger_notices

Вызывает уведомления (возникновения ошибок) для определенной неисправности.

Параметры:

• fault_id (обязательно): идентификатор неисправности
• project_id (необязательно): идентификатор проекта
• limit (необязательно): количество уведомлений (по умолчанию: 10, макс: 100)

analyze_honeybadger_issue

Предоставляет комплексный анализ с предложениями по исправлению.

Параметры:

• fault_id (обязательно): идентификатор неисправности
• project_id (необязательно): идентификатор проекта
• include_context (необязательно): включить контекст запроса (по умолчанию: true)

Пример рабочего процесса

1. Список последних ошибок : «Показать мне последние нерешенные ошибки в производстве»
2. Проанализируйте конкретную ошибку : «Проанализируйте ошибку Honeybadger 12345 и предложите исправления»
3. Получить контекст ошибки : «Получить последние случаи возникновения ошибки 12345 с полным контекстом»
4. Обзор и исправление : используйте анализ, чтобы понять и исправить проблему в вашем коде.

Поиск неисправностей

Общие проблемы

1. Ошибка аутентификации : проверьте правильность ключа API и наличие соответствующих разрешений.
2. Проект не найден : проверьте правильность идентификатора вашего проекта.
3. Проблемы с подключением : проверьте сетевой доступ к API Honeybadger

Режим отладки

Запустите сервер напрямую, чтобы увидеть сообщения об ошибках:

Журналы

Проверьте журналы курсора на предмет проблем, связанных с MCP:

• macOS: ~/Library/Logs/Cursor/
• Windows: %APPDATA%\Cursor\logs\
• Linux: ~/.config/Cursor/logs/

Заметки о безопасности

• Храните ключи API в безопасности и никогда не передавайте их в систему контроля версий.
• По возможности используйте API-ключи, специфичные для конкретной среды.
• Рассмотрите возможность использования API-токенов только для чтения для этой интеграции.
• Регулярно меняйте ключи API

Внося вклад

Чтобы расширить этот сервер MCP:

1. Добавить новые инструменты в метод setupToolHandlers()
2. Реализовать соответствующие методы обработчика
3. Обновите список инструментов и документацию
4. Тщательно протестируйте свою настройку Honeybadger

Поддерживать

По вопросам:

• Этот сервер MCP : проверьте код и конфигурацию
• Honeybadger API : см. документацию по Honeybadger API.
• Интеграция Cursor MCP : проверьте документацию Cursor