New Relic MCP Server

Подключите вашего AI-ассистента к New Relic — безопасно.

Производственно-ориентированный, самостоятельно размещаемый сервер Model Context Protocol (MCP), который предоставляет Claude, Cursor, Codex и другим MCP-клиентам типизированный, по умолчанию только для чтения доступ к NRQL, логам, метрикам, трейсам, ошибкам, сущностям, оповещениям, инцидентам, дашбордам, Synthetics, workloads, service levels и выбранным административным API — все через NerdGraph от New Relic.

Он намеренно не предоставляет произвольный GraphQL, не передает учетные данные клиента в New Relic и не принимает ключи New Relic в качестве аргументов инструментов. Мутации отсутствуют, если их функциональные шлюзы явно не включены, и каждая запись использует рабочий процесс: dry-run → confirmation-phrase → post-write readback.

Основные возможности

• 🔒 Безопасность по умолчанию — только чтение из коробки; записываются по желанию, с ограничениями, и выполняют поток: dry-run → confirmation-phrase → post-write readback.

• 🧱 Ограниченная поверхность API — фиксированный, документированный набор операций NerdGraph; никакого произвольного GraphQL и никаких учетных данных, передаваемых в качестве аргументов инструментов.

• 🔌 Работает с любым MCP-клиентом — Claude Code, Claude Desktop, Cursor, Codex и другие, через stdio или stateless Streamable HTTP.

• 📈 Встроенная телеметрия использования — конечная точка Prometheus /metrics с подсчетами вызовов, длительностью и результатами по каждому инструменту, а также метрики вышестоящего NerdGraph, глубины очереди, повторных попыток, ограничения скорости и кэша.

• 🏢 Готовность к корпоративному использованию — аутентификация bearer/OIDC, белые списки Host/Origin, белые списки учетных записей, редактирование секретов и PII, Docker и Helm.

• 🧰 Широкий охват — независимо выбираемые наборы инструментов для NRQL, сущностей, оповещений, дашбордов, Synthetics, workloads, service levels, логов и метрик.

• 📚 Документировано и протестировано — документация по архитектуре, ADR и набор модульных/интеграционных/контрактных/тестов безопасности/нагрузочных тестов, который проверяет каждое изменение в CI.

Related MCP server: New Relic MCP Server

Что вы можете спросить

После подключения задавайте вопросы вашему MCP-клиенту на простом языке — он выберет и вызовет нужные инструменты только для чтения:

• "Какие транзакции самые медленные для сервиса оформления заказа за последний час?"

• "Обобщите открытые инциденты для команды платежей и их вероятные причины."

• "Какие service levels рискуют не достичь своей цели на этой неделе?"

• "Просмотрите мои политики оповещений и укажите пробелы в покрытии."

• "Почему синтетический монитор входа в систему вышел из строя за ночь?"

Смотрите каталог инструментов для полного набора возможностей.

Почему этот MCP?

New Relic предлагает официальный MCP-сервер, размещенный New Relic (New Relic AI MCP, в настоящее время в предварительной версии). Этот проект является дополнительной, самостоятельно размещаемой и открытой альтернативой. Выбирайте его, когда хотите:

• Самостоятельное размещение и контроль — запускайте MCP-мост внутри вашей собственной сети с вашими собственными учетными данными; только исходящие вызовы NerdGraph покидают ваш периметр. (Предварительная версия New Relic не предлагается для учетных записей, регулируемых FedRAMP.)

• Только чтение по умолчанию, с ограниченными записями — каждая мутация является опциональной и выполняет поток: dry-run → confirmation-phrase → readback.

• Фиксированная, проверяемая поверхность операций — документированный набор операций NerdGraph, без произвольного GraphQL и без передачи ключей New Relic в качестве аргументов инструментов.

• Ваши собственные средства контроля — аутентификация bearer/OIDC, белые списки Host/Origin и учетных записей, редактирование секретов и независимо выбираемые наборы инструментов.

• Телеметрия первого класса — метрики Prometheus для использования инструментов и вышестоящих вызовов, которые вы можете собирать в свой существующий стек наблюдаемости.

• Apache-2.0 и возможность форка — проверяйте, фиксируйте и расширяйте именно то, что развертываете.

Если вы предпочитаете опыт с нулевым управлением, управляемый New Relic и интегрированный с New Relic AI, официальный сервер может подойти лучше. Этот проект обменивает это удобство на самостоятельное размещение, контроль и проверяемость.

Статус проекта: 1.0.0. Просмотрите матрицу поддерживаемых операций и проверьте разрешения на непродуктивной учетной записи New Relic перед включением записи. Метаданные MCP Registry, npm, контейнера и MCPB подготовлены, но этот репозиторий не публикует артефакты без учетных данных мейнтейнера.

Требования

• Node.js 22.7.5 или новее; для производства рекомендуется Node 24 LTS.

• Ключ пользователя New Relic с только теми разрешениями, которые требуют включенные наборы инструментов.

• Учетная запись New Relic, использующая конечную точку US или EU, или проверенное развертывание конечной точки совместимости JP (см. конфигурацию).

• MCP-клиент, поддерживающий stdio или Streamable HTTP.

New Relic применяет ограничение в 25 одновременных запросов NerdGraph на пользователя по всем ключам, принадлежащим этому пользователю. Этот сервер по умолчанию использует 20 общих запросов и пять сложных запросов NRQL. Смотрите производительность и масштабирование перед добавлением реплик. Обычные HTTP-вызовы не имеют сессий; отмена SDK prompt через несколько реплик дополнительно требует детерминированной привязки балансировщика нагрузки.

Быстрый старт: stdio

Установите пакет глобально:

npm install --global @meet-bhalodiya/newrelic-mcp
export NEW_RELIC_API_KEY='NRAK-...'
export NEW_RELIC_REGION='US'
newrelic-mcp doctor --json
newrelic-mcp

Или позвольте MCP-клиенту вызвать закрепленный пакет через npx:

NEW_RELIC_API_KEY='NRAK-...' \
  npx -y @meet-bhalodiya/newrelic-mcp@1.0.0 doctor --json

Stdio резервирует stdout для кадров MCP. Диагностика времени выполнения и логи отправляются в stderr.

Быстрый старт: аутентифицированный HTTP

Создайте два файла, доступные для чтения только учетной записи службы:

install -m 0700 -d ./secrets
printf '%s' "$NEW_RELIC_API_KEY" > ./secrets/new_relic_api_key
openssl rand -hex 32 > ./secrets/mcp_bearer_token
chmod 0400 ./secrets/*

Запустите контейнер только с loopback:

docker compose up --build

Конечная точка MCP — http://127.0.0.1:3000/mcp; проверки работоспособности находятся по адресам /healthz и /readyz. Docker Compose намеренно включает статическую аутентификацию bearer. Прочитайте токен из ./secrets/mcp_bearer_token и отправьте его в Authorization: Bearer <token>.

Для нативного процесса:

export NEW_RELIC_API_KEY_FILE="$PWD/secrets/new_relic_api_key"
export MCP_AUTH_MODE=bearer
export MCP_BEARER_TOKEN_FILE="$PWD/secrets/mcp_bearer_token"
newrelic-mcp http --host 127.0.0.1 --port 3000

HTTP не через loopback должен использовать аутентификацию bearer или OIDC, явный белый список Host, TLS на обратном прокси и белый список Origin для браузерных клиентов. Смотрите развертывание и безопасность.

Настройка клиента

Эти краткие примеры используют сервер stdio только для чтения. Полное руководство включает удаленные настройки bearer и OAuth, а также особенности для конкретных клиентов.

Claude Code

claude mcp add --transport stdio --scope user \
  --env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \
  --env NEW_RELIC_REGION=US \
  newrelic -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0

Используйте /mcp внутри Claude Code для проверки подключения.

Claude Desktop

Для самой безопасной локальной установки соберите или загрузите пакет .mcpb и используйте Настройки → Расширения → Дополнительные настройки → Установить расширение. Claude Desktop хранит поля, помеченные как конфиденциальные, в защищенном хранилище ОС. Пример ручной локальной конфигурации stdio JSON находится в конфигурации клиента. Удаленные серверы должны добавляться через Настройки → Соединители, а не через claude_desktop_config.json.

Cursor

Скопируйте examples/cursor.mcp.json в .cursor/mcp.json для одного проекта или ~/.cursor/mcp.json глобально. Запустите Cursor из среды, где доступен NEW_RELIC_API_KEY, затем включите сервер в настройках MCP.

Codex

codex mcp add newrelic \
  --env NEW_RELIC_REGION=US \
  --env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \
  -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0
codex mcp list

Codex CLI, расширение Codex IDE и настольное приложение ChatGPT на одном хосте Codex используют общий config.toml. Смотрите примеры Codex для режимов Streamable HTTP bearer и OAuth.

CLI

newrelic-mcp [stdio]
newrelic-mcp http [--host HOST] [--port PORT]
newrelic-mcp doctor [--json]
newrelic-mcp tools [--json]

• stdio (или без подкоманды) запускает локальный транспорт.

• http обслуживает Streamable HTTP без сессий по адресу /mcp плюс конечные точки работоспособности; его ограниченный реестр отмены является локальным для процесса.

• doctor проверяет конфигурацию, учетные данные, регион, доступные учетные записи и один ограниченный выбор схемы фиксированного запроса для каждого фактически включенного набора инструментов; он никогда не выполняет мутации и не выводит секреты.

• tools сообщает о включенных наборах инструментов и защитных шлюзах без обращения к New Relic.

Модель безопасности

Включение шлюза регистрирует соответствующий инструмент; это не обходит разрешения New Relic или области авторизации HTTP. Записи по умолчанию все еще выполняют dry-run. Примените точную фразу подтверждения, возвращенную dry-run, используя в остальном идентичные аргументы. Фразы подтверждения привязываются к нормализованному изменению и состоянию до чтения; другое изменение состояния требует нового dry-run.

Проект намеренно исключает создание ключей API, мутацию синтетических защищенных учетных данных, пароли и сбросы живых дашбордов, URL-адреса исторического экспорта, создание назначений Slack, произвольное удаление сущностей, прием телеметрии и сырой GraphQL.

Наборы инструментов и возможности MCP

Поверхность чтения по умолчанию разделена на независимо выбираемые наборы инструментов:

• core

• nrql

• entities

• alerts

• dashboards

• synthetics

• workloads

• service-levels

• logs

• metrics

• admin (никогда не включается неявно)

Используйте newrelic-mcp tools --json для точного каталога времени выполнения и tool-catalog.md для описаний. Ресурсы включают возможности сервера, учетные записи и типизированные шаблоны сущностей/конфигурации. Статические подсказки охватывают триаж инцидентов, работоспособность сервисов, проверку политик оповещений, проверку SLO, дизайн дашбордов и анализ синтетических сбоев. Инструменты остаются авторитетным универсальным интерфейсом, поскольку поддержка подсказок и ресурсов различается между MCP-клиентами.

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

Конфигурация проверяется при запуске. Наиболее важные настройки:

NEW_RELIC_API_KEY=                  # xor NEW_RELIC_API_KEY_FILE
NEW_RELIC_REGION=US                 # US, EU, or JP
NEW_RELIC_DEFAULT_ACCOUNT_ID=
NEW_RELIC_ACCOUNT_ALLOWLIST=
NEW_RELIC_TOOLSETS=core,nrql,entities
MCP_AUTH_MODE=none                  # none, bearer, oidc

Секреты на основе файлов предпочтительны для служб и принимают то же значение, что и их эквиваленты в среде. Не устанавливайте обе формы. Просмотрите configuration.md для приоритета, каждой настройки, правил проверки и примеров.

Разработка

npm ci
npm run build
npm run lint
npm run typecheck
npm test
npm run verify
npm pack --dry-run

Запустите локально с портом HTTP, специфичным для рабочей области:

CONDUCTOR_PORT=3100 npm run dev:http

Опциональные живые тесты требуют явной учетной записи и являются только для чтения, если не установлен отдельный флаг записи для одноразовой учетной записи. Смотрите development.md и CONTRIBUTING.md.

Документация

• Архитектура

• Справочник по конфигурации

• Каталог инструментов

• Разрешения и редакции New Relic

• Конфигурация клиента

• Развертывание

• Производительность

• Безопасность и модель угроз

• Устранение неполадок

• Матрица источников официального API

• Процесс выпуска

• Политика зависимостей

• Архитектурные решения

Вклад

Приветствуются вклады — сообщения об ошибках, функции, подкрепленные официальной документацией New Relic, документация и тесты. Начните с CONTRIBUTING.md и первых хороших задач. Все участники следуют Кодексу поведения.

Если этот проект полезен вам или вашей команде, ⭐ помогает другим найти его.

Поддержка и безопасность

Нужна помощь? Смотрите SUPPORT.md. Используйте GitHub Issues для воспроизводимых ошибок и запросов функций, и никогда не включайте ключи New Relic, токены-носители, NRQL, данные учетных записей, сведения об объектах, необработанные ответы или предварительно подписанные URL.

Сообщайте об уязвимостях конфиденциально в соответствии с SECURITY.md.

Лицензия

Apache License 2.0. См. LICENSE.