Servidor MCP de New Relic

Conecta tu asistente de IA a New Relic de forma segura.

Un servidor Model Context Protocol (MCP) orientado a producción y autoalojable que proporciona a Claude, Cursor, Codex y otros clientes MCP acceso tipificado y de solo lectura por defecto a NRQL, logs, métricas, trazas, errores, entidades, alertas, incidentes, paneles, sintéticos, cargas de trabajo, niveles de servicio y APIs de administración seleccionadas, todo a través de NerdGraph de New Relic.

Deliberadamente no expone GraphQL arbitrario, reenvía credenciales de cliente a New Relic ni acepta claves de New Relic como argumentos de herramientas. Las mutaciones están ausentes a menos que sus puertas de funcionalidad estén explícitamente habilitadas, y cada escritura utiliza un flujo de ejecución en seco, frase de confirmación y relectura posterior a la escritura.

Aspectos destacados

• 🔒 Seguro por defecto — solo lectura de fábrica; las escrituras son opcionales, controladas y siguen un flujo de ejecución en seco → frase de confirmación → relectura posterior a la escritura.

• 🧱 Superficie de API acotada — un conjunto fijo y documentado de operaciones de NerdGraph; sin GraphQL arbitrario ni credenciales pasadas como argumentos de herramientas.

• 🔌 Funciona con cualquier cliente MCP — Claude Code, Claude Desktop, Cursor, Codex y más, a través de stdio o HTTP Streamable sin estado.

• 📈 Telemetría de uso integrada — un endpoint Prometheus /metrics con recuentos de llamadas por herramienta, duraciones y resultados, además de métricas de NerdGraph ascendente, profundidad de cola, reintentos, límite de velocidad y caché.

• 🏢 Preparado para empresas — autenticación bearer/OIDC, listas de permitidos de Host/Origen, listas de permitidos de cuentas, redacción de secretos y PII, Docker y Helm.

• 🧰 Amplia cobertura — conjuntos de herramientas seleccionables de forma independiente para NRQL, entidades, alertas, paneles, sintéticos, cargas de trabajo, niveles de servicio, logs y métricas.

• 📚 Documentado y probado — documentación de arquitectura, ADR y un conjunto de pruebas unitarias, de integración, de contrato, de seguridad y de carga que controla cada cambio en CI.

Related MCP server: New Relic MCP Server

Qué puedes preguntar

Una vez conectado, pregunta a tu cliente MCP en lenguaje natural — él selecciona y llama a las herramientas de solo lectura adecuadas por ti:

• "¿Cuáles son las transacciones más lentas para el servicio de pago en la última hora?"

• "Resume los incidentes abiertos para el equipo de pagos y sus causas probables."

• "¿Qué niveles de servicio están en riesgo de no cumplir su objetivo esta semana?"

• "Revisa mis políticas de alerta y señala las brechas de cobertura."

• "¿Por qué falló el monitor sintético de inicio de sesión durante la noche?"

Consulta el catálogo de herramientas para conocer el conjunto completo de capacidades.

Por qué este MCP?

New Relic ofrece un servidor MCP oficial alojado por New Relic (New Relic AI MCP, actualmente en vista previa). Este proyecto es una alternativa complementaria, autoalojable y de código abierto. Elígelo cuando quieras:

• Autoalojamiento y control — ejecuta el puente MCP dentro de tu propia red con tus propias credenciales; solo las llamadas salientes a NerdGraph abandonan tu perímetro. (La vista previa de New Relic no se ofrece para cuentas reguladas por FedRAMP).

• Solo lectura por defecto, con escrituras controladas — cada mutación es opcional y sigue un flujo de ejecución en seco → frase de confirmación → relectura.

• Una superficie de operación fija y auditable — un conjunto documentado de operaciones de NerdGraph, sin GraphQL arbitrario y sin claves de New Relic pasadas como argumentos de herramientas.

• Tus propios controles — autenticación bearer/OIDC, listas de permitidos de Host/Origen y cuentas, redacción de secretos y conjuntos de herramientas seleccionables de forma independiente.

• Telemetría de primera clase — métricas Prometheus para el uso de herramientas y llamadas ascendentes que puedes integrar en tu pila de observabilidad existente.

• Apache-2.0 y bifurcable — inspecciona, fija y extiende exactamente lo que implementas.

Si prefieres una experiencia sin operaciones gestionada por New Relic e integrada con New Relic AI, el servidor oficial puede ser la mejor opción. Este proyecto intercambia esa conveniencia por autoalojamiento, control y auditabilidad.

Estado del proyecto: 1.0.0. Revisa la matriz de operaciones compatibles y valida los permisos contra una cuenta de New Relic que no sea de producción antes de habilitar escrituras. El Registro MCP, npm, el contenedor y los metadatos MCPB están preparados, pero este repositorio no publica artefactos sin credenciales de mantenedor.

Requisitos

• Node.js 22.7.5 o superior; se recomienda Node 24 LTS para producción.

• Una clave de usuario de New Relic con solo los permisos que requieren los conjuntos de herramientas habilitados.

• Una cuenta de New Relic que utilice el endpoint de EE. UU. o la UE, o una implementación de endpoint de JP verificada (consulta configuración).

• Un cliente MCP que admita stdio o HTTP Streamable.

New Relic aplica un límite de 25 solicitudes simultáneas a NerdGraph por usuario en todas las claves propiedad de ese usuario. Este servidor tiene un valor predeterminado de 20 solicitudes totales y cinco consultas NRQL complejas. Consulta rendimiento y escalado antes de añadir réplicas. Las llamadas HTTP ordinarias no tienen sesión; la cancelación rápida del SDK en múltiples réplicas requiere además una afinidad determinista del balanceador de carga.

Inicio rápido: stdio

Instala el paquete globalmente:

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

O deja que el cliente MCP invoque el paquete fijado a través de npx:

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

Stdio reserva stdout para tramas MCP. Los diagnósticos y logs de tiempo de ejecución van a stderr.

Inicio rápido: HTTP autenticado

Crea dos archivos legibles solo por la cuenta de servicio:

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/*

Inicia un contenedor solo de bucle invertido:

docker compose up --build

El endpoint MCP es http://127.0.0.1:3000/mcp; las sondas de salud están en /healthz y /readyz. Docker Compose habilita deliberadamente la autenticación bearer estática. Lee el token de ./secrets/mcp_bearer_token y envíalo en Authorization: Bearer <token>.

Para un proceso nativo:

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

El HTTP que no sea de bucle invertido debe usar autenticación bearer u OIDC, una lista de permitidos de Host explícita, TLS en el proxy inverso y una lista de permitidos de Origen para clientes de navegador. Consulta implementación y seguridad.

Configuración del cliente

Estos breves ejemplos utilizan el servidor stdio de solo lectura. La guía completa incluye configuraciones remotas bearer y OAuth, además de advertencias específicas del cliente.

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

Usa /mcp dentro de Claude Code para verificar la conexión.

Claude Desktop

Para la instalación local más segura, compila o descarga el paquete .mcpb y usa Configuración → Extensiones → Configuración avanzada → Instalar extensión. Claude Desktop almacena los campos marcados como sensibles en el almacenamiento seguro del SO. Un ejemplo manual de JSON stdio local está en configuración del cliente. Los servidores remotos deben añadirse a través de Configuración → Conectores, no de claude_desktop_config.json.

Cursor

Copia examples/cursor.mcp.json a .cursor/mcp.json para un proyecto o a ~/.cursor/mcp.json de forma global. Inicia Cursor desde un entorno donde NEW_RELIC_API_KEY esté disponible, luego habilita el servidor en la configuración de 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, la extensión de Codex para IDE y la aplicación de escritorio de ChatGPT en el mismo host de Codex comparten config.toml. Consulta los ejemplos de Codex para los modos bearer y OAuth de HTTP Streamable.

CLI

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

• stdio (o ningún subcomando) inicia el transporte local.

• http sirve HTTP Streamable sin estado en /mcp más endpoints de salud; su registro de cancelación acotado es local al proceso.

• doctor valida la configuración, credenciales, región, cuentas accesibles y una selección de esquema de consulta fija acotada para cada conjunto de herramientas efectivamente habilitado; nunca emite mutaciones ni imprime secretos.

• tools informa los conjuntos de herramientas habilitados y las puertas de seguridad sin contactar a New Relic.

Modelo de seguridad

Habilitar una puerta registra la herramienta correspondiente; no elude los permisos de New Relic ni los ámbitos de autorización HTTP. Las escrituras siguen teniendo como valor predeterminado la ejecución en seco. Aplica la frase de confirmación exacta devuelta por la ejecución en seco utilizando argumentos por lo demás idénticos. Las frases de confirmación se vinculan al cambio normalizado y al estado previo a la lectura; otro cambio de estado requiere una nueva ejecución en seco.

El proyecto excluye deliberadamente la creación de claves de API, la mutación de credenciales seguras sintéticas, las contraseñas y restablecimientos de paneles en vivo, las URL de exportación histórica, la creación de destinos de Slack, la eliminación arbitraria de entidades, la ingesta de telemetría y GraphQL sin procesar.

Conjuntos de herramientas y capacidades MCP

La superficie de lectura predeterminada se divide en conjuntos de herramientas seleccionables de forma independiente:

• core

• nrql

• entities

• alerts

• dashboards

• synthetics

• workloads

• service-levels

• logs

• metrics

• admin (nunca habilitado implícitamente)

Usa newrelic-mcp tools --json para el catálogo exacto en tiempo de ejecución y tool-catalog.md para las descripciones. Los recursos incluyen capacidades del servidor, cuentas y plantillas tipificadas de entidad/configuración. Los prompts estáticos cubren el triaje de incidencias, la salud del servicio, la revisión de políticas de alerta, la revisión de SLO, el diseño de paneles y el análisis de fallos sintéticos. Las herramientas siguen siendo la interfaz universal autorizada porque la compatibilidad con prompts y recursos varía entre clientes MCP.

Configuración

La configuración se valida al inicio. Los ajustes más importantes son:

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

Los secretos basados en archivos son preferidos para servicios y toman el mismo valor que sus equivalentes de entorno. No establezcas ambas formas. Revisa configuration.md para conocer la precedencia, todos los ajustes, reglas de validación y ejemplos.

Desarrollo

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

Ejecuta localmente con un puerto HTTP específico del espacio de trabajo:

CONDUCTOR_PORT=3100 npm run dev:http

Las pruebas en vivo opcionales requieren una cuenta explícita y son de solo lectura a menos que se establezca el indicador de escritura de cuenta desechable por separado. Consulta development.md y CONTRIBUTING.md.

Documentación

• Arquitectura

• Referencia de configuración

• Catálogo de herramientas

• Permisos y ediciones de New Relic

• Configuración del cliente

• Implementación

• Rendimiento

• Seguridad y modelo de amenazas

• Solución de problemas

• Matriz de fuentes de API oficiales

• Proceso de lanzamiento

• Política de dependencias

• Decisiones de arquitectura

Contribuir

Las contribuciones son bienvenidas: informes de errores, funciones respaldadas por la documentación oficial de New Relic, documentación y pruebas. Comience con CONTRIBUTING.md y los good first issues. Toda participación sigue el Código de conducta.

Si este proyecto le resulta útil a usted o a su equipo, una ⭐ ayuda a que otros lo descubran.

Soporte y seguridad

¿Necesita ayuda? Consulte SUPPORT.md. Use GitHub Issues para errores y solicitudes de funciones reproducibles, y nunca incluya claves de New Relic, tokens de portador, NRQL, datos de cuenta, detalles de entidad, respuestas sin procesar ni URL prefirmadas.

Reporte vulnerabilidades de forma privada según SECURITY.md.

Licencia

Licencia Apache 2.0. Consulte LICENSE.