Новый сервер 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: ExecuteAutomation Database Server

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

Предпосылки

• Python 3.10 или выше

• Аккаунт New Relic и ключ API

• Клод Приложение для рабочего стола

Этапы установки

1. Установите менеджер пакетов 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"

2. Создать и настроить проект:

# 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

3. Создайте файл сервера newrelic_logs_server.py с предоставленным кодом.

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

# 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-запросов

1. Базовый запрос транзакции:

SELECT * FROM Transaction SINCE 1 hour ago

2. Анализ ошибок:

SELECT * FROM Transaction WHERE error IS TRUE SINCE 1 hour ago LIMIT 10

3. Анализ производительности:

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

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

1. Ошибки аутентификации:

• Проверьте правильность установки NEW_RELIC_API_KEY

• Убедитесь, что API-ключ имеет правильные разрешения.

• Убедитесь, что ключ API действителен

2. Ошибки запроса:

• Проверьте синтаксис NRQL

• Проверьте идентификатор учетной записи в коде, соответствует ли он вашей учетной записи

• Убедитесь, что запрашиваемые данные существуют в указанном временном диапазоне.

3. Проблемы с подключением:

• Проверьте сетевое подключение

• Проверьте доступность конечной точки GraphQL

• Убедитесь, что брандмауэры не блокируют соединения.

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

• Никогда не передавайте ключи API в систему контроля версий

• Используйте переменные среды для конфиденциальных данных

• Поддерживайте актуальность зависимостей

• Мониторинг шаблонов запросов и журналов доступа

Разработка

Локальное тестирование

1. Установите переменные среды:

export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"

2. Запускаем сервер:

uv run newrelic_logs_server.py

Структура кода

Сервер реализует:

• Инструмент для создания единого запроса NRQL

• Настраиваемый идентификатор учетной записи New Relic

• Комплексная обработка ошибок

• Подробная регистрация

• Форматирование ответа

Тестирование изменений

1. При необходимости измените код.

2. Тест с MCP Inspector

3. Перезапустите Claude Desktop, чтобы изменения вступили в силу.

Руководство по устранению неполадок

1. Сервер не запускается:

• Проверить версию Python

• Убедитесь, что все зависимости установлены.

• Убедитесь, что виртуальная среда активирована

2. Запрос не работает:

• Проверьте журналы на наличие подробных сообщений об ошибках.

• Проверьте синтаксис NRQL

• Убедитесь, что данные существуют в запрашиваемом диапазоне времени

3. Клод не подключается:

• Проверьте синтаксис файла конфигурации

• Проверьте абсолютные пути

• Перезагрузить рабочий стол Клода

Внося вклад

1. Форк репозитория

2. Создать ветку функций

3. Отправить запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT.

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

Если у вас возникли проблемы:

1. Проверьте журналы.

2. Просмотрите раздел общих проблем

3. Тест с MCP Inspector

4. Сообщить о проблеме на GitHub