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: Linode MCP Server

Installationsanweisungen

Voraussetzungen

Python 3.10 oder höher
New Relic-Konto und API-Schlüssel
Claude Desktop-Anwendung

Installationsschritte

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"

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

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

Grundlegende Transaktionsabfrage:

SELECT * FROM Transaction SINCE 1 hour ago

Fehleranalyse:

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

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

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

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

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

Umgebungsvariablen festlegen:

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

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

Ändern Sie den Code nach Bedarf
Testen mit MCP Inspector
Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen

Handbuch zur Fehlerbehebung

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

Abfrage funktioniert nicht:

Überprüfen Sie die Protokolle auf detaillierte Fehlermeldungen
Überprüfen der NRQL-Syntax
Sicherstellen, dass im abgefragten Zeitbereich Daten vorhanden sind

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

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Senden einer Pull-Anfrage

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Unterstützung

Wenn Probleme auftreten:

Überprüfen Sie die Protokolle
Abschnitt „Häufige Probleme“ lesen
Testen mit MCP Inspector
Melden Sie ein Problem auf GitHub

New Relic MCP Server