Новый сервер Relic MCP

Простой сервер Model Context Protocol (MCP) для запросов журналов New Relic с использованием запросов NRQL. Этот сервер позволяет моделям Large Language Models (LLM), таким как Claude, взаимодействовать с вашими данными New Relic.

Функции

Запрос журналов и метрик New Relic с использованием NRQL
Подробная регистрация ошибок
Простая интеграция с Claude Desktop
Форматирование выходных данных, понятное человеку
Настраиваемый идентификатор учетной записи New Relic

Related MCP server: Linode MCP Server

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

Предпосылки

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

New Relic MCP Server