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