Новый сервер Relic MCP
Простой сервер Model Context Protocol (MCP) для зап��осов журналов New Relic с использованием запросов NRQL. Этот сервер позволяет моделям Large Language Models (LLM), таким как Claude, взаимодействовать с вашими данными New Relic.
Функции
- Запрос журналов и метрик New Relic с использованием NRQL
- Подробная регистрация ошибок
- Простая интеграция с Claude Desktop
- Форматирование выходных данных, понятное человеку
- Настраиваемый идентификатор учетной записи New Relic
Инструкции по установке
Предпосылки
- Python 3.10 или выше
- Аккаунт New Relic и ключ API
- Клод Приложение для рабочего стола
Этапы установки
- Установите менеджер пакетов
uv :
# On macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# On Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
- Создать и настроить проект:
# Create directory
mkdir newrelic-mcp
cd newrelic-mcp
# Create virtual environment
uv venv
# Activate virtual environment
source .venv/bin/activate # On Unix/macOS
.venv\Scripts\activate # On Windows
# Install dependencies
uv pip install "mcp[cli]" httpx
- Создайте файл сервера
newrelic_logs_server.py с предоставленным кодом. - Настройте переменные среды:
# On Unix/macOS
export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"
# On Windows (CMD)
set NEW_RELIC_API_KEY=your-api-key-here
set NEW_RELIC_ACCOUNT_ID=your-account-id-here
# On Windows (PowerShell)
$env:NEW_RELIC_API_KEY = "your-api-key-here"
$env:NEW_RELIC_ACCOUNT_ID = "your-account-id-here"
Интеграция рабочего стола Клода
Настройте Claude Desktop, отредактировав файл конфигурации:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Добавьте следующую конфигурацию:
{
"mcpServers": {
"newrelic": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/newrelic-mcp",
"run",
"newrelic_logs_server.py"
],
"env": {
"NEW_RELIC_API_KEY": "your-api-key-here",
"NEW_RELIC_ACCOUNT_ID": "your-account-id-here"
}
}
}
}
Использование
Примеры NRQL-запросов
- Базовый запрос транзакции:
SELECT * FROM Transaction SINCE 1 hour ago
- Анализ ошибок:
SELECT * FROM Transaction WHERE error IS TRUE SINCE 1 hour ago LIMIT 10
- Анализ производительности:
SELECT average(duration) FROM Transaction FACET name ORDER BY average(duration) DESC LIMIT 5
Пример Клода Подсказки
Вы можете задать Клоду такие вопросы:
- «Покажи мне все транзакции за последний час»
- «Есть ли ошибки в нашем приложении?»
- «Каковы наши самые медленные конечные точки?»
Отладка
Просмотр журналов
# On macOS/Linux
tail -f ~/Library/Logs/Claude/mcp-server-newrelic.log
# On Windows
type %APPDATA%\Claude\logs\mcp-server-newrelic.log
Тестирование с помощью MCP Inspector
Проверьте работоспособность вашего сервера, используя:
npx @modelcontextprotocol/inspector uv run newrelic_logs_server.py
Общие проблемы
- Ошибки аутентификации:
- Проверьте правильность установки NEW_RELIC_API_KEY
- Убедитесь, что API-ключ имеет правильные разрешения.
- Убедитесь, что ключ API действителен
- Ошибки запроса:
- Проверьте синтаксис NRQL
- Проверьте идентификатор учетной записи в коде, соответствует ли он вашей учетной записи
- Убедитесь, что запрашиваемые данные существуют в указанном временном диапазоне.
- Проблемы с подключением:
- Проверьте сетевое подключение
- Проверьте доступность конечной точки GraphQL
- Убедитесь, что брандмауэры не блокируют соединения.
Заметки о безопасности
- Никогда не передавайте ключи API в систему контроля версий
- Используйте переменные среды для конфиденциальных данных
- Поддерживайте актуальность зависимостей
- Мониторинг шаблонов запросов и журналов доступа
Разработка
Локальное тестирование
- Установите переменные среды:
export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"
- Запускаем сервер:
uv run newrelic_logs_server.py
Структура кода
Сервер реализует:
- Инструмент для создания единого запроса NRQL
- Настраиваемый идентификатор учетной записи New Relic
- Комплексная обработка ошибок
- Подробная регистрация
- Форматирование ответа
Тестирование изменений
- При необходимости измените код.
- Тест с MCP Inspector
- Перезапустите Claude Desktop, чтобы изменения вступили в силу.
Руководство по устранению неполадок
- Сервер не запускается:
- Проверить версию Python
- Убедитесь, что все зависимости установлены.
- Убедитесь, что виртуальная среда активирована
- Запрос не работает:
- Проверьте журналы на наличие подробных сообщений об ошибках.
- Проверьте синтаксис NRQL
- Убедитесь, что данные существуют в запрашиваемом диапазоне времени
- Клод не подключается:
- Проверьте синтаксис файла конфигурации
- Проверьте абсолютные пути
- Перезагрузить рабочий стол Клода
Внося вклад
- Форк репозитория
- Создать ветку функций
- Отправить запрос на извлечение
Лицензия
Данный проект лицензирован по лицензии MIT.
Поддерживать
Если у вас возникли проблемы:
- Проверьте журналы.
- Просмотрите раздел общих проблем
- Тест с MCP Inspector
- Сообщить о проблеме на GitHub