Servidor MCP de New Relic

Un servidor simple de Protocolo de Contexto de Modelo (MCP) para consultar registros de New Relic mediante consultas NRQL. Este servidor permite que los Modelos de Lenguaje Grandes (LLM), como Claude, interactúen con sus datos de New Relic.

Características

Consultar registros y métricas de New Relic mediante NRQL
Registro detallado de errores
Fácil integración con Claude Desktop
Formato de salida legible para humanos
ID de cuenta de New Relic configurable

Instrucciones de configuración

Prerrequisitos

Python 3.10 o superior
Cuenta y clave API de New Relic
Aplicación de escritorio Claude

Pasos de instalación

Instalar el administrador de paquetes 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"

Crear y configurar el proyecto:

# 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

Cree el archivo de servidor newrelic_logs_server.py con el código proporcionado.
Configure sus variables de entorno:

# 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"

Integración de escritorio de Claude

Configure Claude Desktop editando su archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Agregue la siguiente configuración:

{
    "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"
            }
        }
    }
}

Uso

Ejemplos de consultas NRQL

Consulta de transacción básica:

SELECT * FROM Transaction SINCE 1 hour ago

Análisis de errores:

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

Análisis de rendimiento:

SELECT average(duration) FROM Transaction FACET name ORDER BY average(duration) DESC LIMIT 5

Ejemplo de indicaciones de Claude

Puedes hacerle preguntas a Claude como:

"Muéstrame todas las transacciones de la última hora"
"¿Hay algún error en nuestra aplicación?"
"¿Cuáles son nuestros puntos finales más lentos?"

Depuración

Visualización de registros

# On macOS/Linux
tail -f ~/Library/Logs/Claude/mcp-server-newrelic.log

# On Windows
type %APPDATA%\Claude\logs\mcp-server-newrelic.log

Pruebas con MCP Inspector

Pruebe la funcionalidad de su servidor utilizando:

npx @modelcontextprotocol/inspector uv run newrelic_logs_server.py

Problemas comunes

Errores de autenticación:

Compruebe si NEW_RELIC_API_KEY está configurado correctamente
Verificar que la clave API tenga los permisos correctos
Asegúrese de que la clave API sea válida

Errores de consulta:

Verificar la sintaxis NRQL
Verifique que el ID de la cuenta en el código coincida con su cuenta
Asegúrese de que los datos consultados existan en el rango de tiempo

Problemas de conexión:

Comprobar la conectividad de la red
Verificar que el punto final de GraphQL sea accesible
Asegúrese de que no haya firewalls bloqueando las conexiones

Notas de seguridad

Nunca envíe claves API al control de versiones
Utilice variables de entorno para datos confidenciales
Mantener las dependencias actualizadas
Supervisar patrones de consulta y registros de acceso

Desarrollo

Pruebas locales

Establecer variables de entorno:

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

Ejecutar el servidor:

uv run newrelic_logs_server.py

Estructura del código

El servidor implementa:

Herramienta de consulta NRQL única
ID de cuenta de New Relic configurable
Manejo integral de errores
Registro detallado
Formato de respuesta

Probando cambios

Modificar el código según sea necesario
Prueba con MCP Inspector
Reinicie Claude Desktop para aplicar los cambios

Guía de solución de problemas

El servidor no se inicia:

Comprobar la versión de Python
Verificar que todas las dependencias estén instaladas
Asegúrese de que el entorno virtual esté activado

La consulta no funciona:

Consulte los registros para ver mensajes de error detallados
Verificar la sintaxis NRQL
Asegúrese de que los datos existan en el rango de tiempo consultado

Claude no se conecta:

Verificar la sintaxis del archivo de configuración
Comprobar que las rutas son absolutas
Reiniciar Claude Desktop

Contribuyendo

Bifurcar el repositorio
Crear una rama de características
Enviar una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Apoyo

Si encuentra problemas:

Revisar los registros
Revisar la sección de problemas comunes
Prueba con MCP Inspector
Presentar un problema en GitHub

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite que los modelos de lenguaje grandes como Claude consulten registros y métricas de New Relic mediante consultas NRQL.

Appeared in Searches

How to view console logs of webpages