Neuer Relic MCP-Server

Ein einfacher Model Context Protocol (MCP)-Server zum Abfragen von New Relic-Protokollen mithilfe von NRQL-Abfragen. Dieser Server ermöglicht Large Language Models (LLMs) wie Claude die Interaktion mit Ihren New Relic-Daten.

Merkmale

• Abfragen von New Relic-Protokollen und -Metriken mit NRQL

• Detaillierte Fehlerprotokollierung

• Einfache Integration mit Claude Desktop

• Für Menschen lesbare Ausgabeformatierung

• Konfigurierbare New Relic-Konto-ID

Related MCP server: Datadog MCP Server

Installationsanweisungen

Voraussetzungen

• Python 3.10 oder höher

• New Relic-Konto und API-Schlüssel

• Claude Desktop-Anwendung

Installationsschritte

1. Installieren Sie uv Paketmanager:

# 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. Projekt erstellen und einrichten:

# 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. Erstellen Sie die Serverdatei newrelic_logs_server.py mit dem bereitgestellten Code.

4. Konfigurieren Sie Ihre Umgebungsvariablen:

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

Konfigurieren Sie Claude Desktop, indem Sie Ihre Konfigurationsdatei bearbeiten:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Fügen Sie die folgende Konfiguration hinzu:

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

Verwendung

Beispiele für NRQL-Abfragen

1. Grundlegende Transaktionsabfrage:

SELECT * FROM Transaction SINCE 1 hour ago

2. Fehleranalyse:

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

3. Leistungsanalyse:

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

Beispiel für Claude-Eingabeaufforderungen

Sie können Claude Fragen stellen wie:

• „Zeige mir alle Transaktionen der letzten Stunde“

• „Enthält unsere Bewerbung Fehler?“

• „Was sind unsere langsamsten Endpunkte?“

Debuggen

Anzeigen von Protokollen

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

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

Testen mit MCP Inspector

Testen Sie die Funktionalität Ihres Servers mit:

npx @modelcontextprotocol/inspector uv run newrelic_logs_server.py

Häufige Probleme

1. Authentifizierungsfehler:

• Überprüfen Sie, ob NEW_RELIC_API_KEY richtig eingestellt ist

• Überprüfen Sie, ob der API-Schlüssel über die richtigen Berechtigungen verfügt

• Stellen Sie sicher, dass der API-Schlüssel gültig ist

2. Abfragefehler:

• Überprüfen der NRQL-Syntax

• Überprüfen Sie, ob die Konto-ID im Code mit Ihrem Konto übereinstimmt.

• Sicherstellen, dass abgefragte Daten im Zeitbereich vorhanden sind

3. Verbindungsprobleme:

• Überprüfen der Netzwerkkonnektivität

• Überprüfen Sie, ob der GraphQL-Endpunkt zugänglich ist

• Stellen Sie sicher, dass keine Firewalls Verbindungen blockieren

Sicherheitshinweise

• Übergeben Sie API-Schlüssel niemals der Versionskontrolle

• Verwenden Sie Umgebungsvariablen für vertrauliche Daten

• Halten Sie Abhängigkeiten auf dem neuesten Stand

• Überwachen Sie Abfragemuster und Zugriffsprotokolle

Entwicklung

Lokale Tests

1. Umgebungsvariablen festlegen:

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

2. Führen Sie den Server aus:

uv run newrelic_logs_server.py

Codestruktur

Der Server implementiert:

• Einzelnes NRQL-Abfragetool

• Konfigurierbare New Relic-Konto-ID

• Umfassende Fehlerbehandlung

• Detaillierte Protokollierung

• Antwortformatierung

Änderungen testen

1. Ändern Sie den Code nach Bedarf

2. Testen mit MCP Inspector

3. Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen

Handbuch zur Fehlerbehebung

1. Server startet nicht:

• Überprüfen Sie die Python-Version

• Überprüfen Sie, ob alle Abhängigkeiten installiert sind

• Stellen Sie sicher, dass die virtuelle Umgebung aktiviert ist

2. Abfrage funktioniert nicht:

• Überprüfen Sie die Protokolle auf detaillierte Fehlermeldungen

• Überprüfen der NRQL-Syntax

• Sicherstellen, dass im abgefragten Zeitbereich Daten vorhanden sind

3. Claude stellt keine Verbindung her:

• Überprüfen der Syntax der Konfigurationsdatei

• Überprüfen Sie, ob die Pfade absolut sind

• Starten Sie Claude Desktop neu

Beitragen

1. Forken Sie das Repository

2. Erstellen eines Feature-Zweigs

3. Senden einer Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Unterstützung

Wenn Probleme auftreten:

1. Überprüfen Sie die Protokolle

2. Abschnitt „Häufige Probleme“ lesen

3. Testen mit MCP Inspector

4. Melden Sie ein Problem auf GitHub