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

Related MCP server: Datadog MCP Server

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

1. 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"

2. 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

3. Cree el archivo de servidor newrelic_logs_server.py con el código proporcionado.

4. 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

1. Consulta de transacción básica:

SELECT * FROM Transaction SINCE 1 hour ago

2. Análisis de errores:

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

3. 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

1. 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

2. 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

3. 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

1. Establecer variables de entorno:

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

2. 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

1. Modificar el código según sea necesario

2. Prueba con MCP Inspector

3. Reinicie Claude Desktop para aplicar los cambios

Guía de solución de problemas

1. 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

2. 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

3. Claude no se conecta:

• Verificar la sintaxis del archivo de configuración

• Comprobar que las rutas son absolutas

• Reiniciar Claude Desktop

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Enviar una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Apoyo

Si encuentra problemas:

1. Revisar los registros

2. Revisar la sección de problemas comunes

3. Prueba con MCP Inspector

4. Presentar un problema en GitHub