New Relic MCP Server

Verbinden Sie Ihren KI-Assistenten sicher mit New Relic.

Ein produktionsorientierter, selbst hostbarer Model Context Protocol (MCP)-Server, der Claude, Cursor, Codex und anderen MCP-Clients typisierten, standardmäßig schreibgeschützten Zugriff auf NRQL, Logs, Metriken, Traces, Fehler, Entitäten, Alarme, Vorfälle, Dashboards, Synthetics, Workloads, Service Levels und ausgewählte Administrations-APIs bietet – alles über New Relics NerdGraph.

Er stellt bewusst kein beliebiges GraphQL bereit, leitet keine Client-Anmeldeinformationen an New Relic weiter und akzeptiert keine New Relic-Schlüssel als Tool-Argumente. Mutationen fehlen, sofern ihre Feature-Gates nicht explizit aktiviert wurden, und jeder Schreibvorgang durchläuft einen Dry-Run-, Bestätigungs- und Rücklese-Workflow.

Höhepunkte

• 🔒 Standardmäßig sicher — schreibgeschützt ab Werk; Schreibvorgänge sind Opt-in, abgesichert und durchlaufen einen Dry-Run → Bestätigungsphrase → Rückleseablauf.

• 🧱 Begrenzte API-Oberfläche — eine festgelegte, dokumentierte Menge von NerdGraph-Operationen; kein beliebiges GraphQL und keine Anmeldeinformationen, die als Tool-Argumente übergeben werden.

• 🔌 Funktioniert mit jedem MCP-Client — Claude Code, Claude Desktop, Cursor, Codex und mehr, über stdio oder zustandsloses Streamable HTTP.

• 📈 Integrierte Nutzungstelemetrie — ein Prometheus-/metrics-Endpunkt mit Aufrufzahlen pro Tool, Dauern und Ergebnissen sowie Upstream-NerdGraph-, Warteschlangentiefen-, Wiederholungs-, Ratenbegrenzungs- und Cache-Metriken.

• 🏢 Unternehmensbereit — Bearer-/OIDC-Authentifizierung, Host-/Origin-Zulassungslisten, Konto-Zulassungslisten, Geheimnis- und PII-Schwärzung, Docker und Helm.

• 🧰 Breite Abdeckung — unabhängig auswählbare Toolsets für NRQL, Entitäten, Alarme, Dashboards, Synthetics, Workloads, Service Levels, Logs und Metriken.

• 📚 Dokumentiert und getestet — Architekturdokumente, ADRs und eine Unit-/Integrations-/Vertrags-/Sicherheits-/Lasttestsuite, die jede Änderung in CI absichert.

Related MCP server: New Relic MCP Server

Was Sie fragen können

Sobald die Verbindung hergestellt ist, fragen Sie Ihren MCP-Client in natürlicher Sprache – er wählt die richtigen schreibgeschützten Tools aus und ruft sie für Sie auf:

• "Was sind die langsamsten Transaktionen für den Checkout-Dienst in der letzten Stunde?"

• "Fasse die offenen Vorfälle für das Zahlungsteam und ihre wahrscheinlichen Ursachen zusammen."

• "Welche Service Levels riskieren, ihr Ziel diese Woche zu verfehlen?"

• "Überprüfe meine Alarmrichtlinien und weise auf Deckungslücken hin."

• "Warum ist der Login-Synthetik-Monitor über Nacht fehlgeschlagen?"

Siehe den Tool-Katalog für den vollständigen Umfang der Fähigkeiten.

Warum dieser MCP?

New Relic bietet einen offiziellen, von New Relic gehosteten MCP-Server (New Relic AI MCP, derzeit in der Vorschau). Dieses Projekt ist eine ergänzende, selbst hostbare und quelloffene Alternative. Wählen Sie es, wenn Sie Folgendes wünschen:

• Selbsthosting und Kontrolle — betreiben Sie die MCP-Brücke in Ihrem eigenen Netzwerk mit Ihren eigenen Anmeldeinformationen; nur ausgehende NerdGraph-Aufrufe verlassen Ihren Perimeter. (Die Vorschau von New Relic wird nicht für FedRAMP-regulierte Konten angeboten.)

• Standardmäßig schreibgeschützt, mit abgesicherten Schreibvorgängen — jede Mutation ist Opt-in und durchläuft einen Dry-Run → Bestätigungsphrase → Rückleseablauf.

• Eine feste, prüfbare Operationsoberfläche — eine dokumentierte Menge von NerdGraph-Operationen, ohne beliebiges GraphQL und ohne New Relic-Schlüssel, die als Tool-Argumente übergeben werden.

• Ihre eigenen Kontrollen — Bearer-/OIDC-Auth, Host-/Origin- und Konto-Zulassungslisten, Geheimnisschwärzung und unabhängig auswählbare Toolsets.

• Erstklassige Telemetrie — Prometheus-Metriken für Toolnutzung und Upstream-Aufrufe, die Sie in Ihren vorhandenen Observability-Stack einspeisen können.

• Apache-2.0 und abspaltbar — inspizieren, festlegen und erweitern Sie genau das, was Sie bereitstellen.

Wenn Sie lieber eine betriebsfreie, von New Relic verwaltete Erfahrung in Verbindung mit New Relic AI wünschen, könnte der offizielle Server die bessere Wahl sein. Dieses Projekt tauscht diesen Komfort gegen Selbsthosting, Kontrolle und Prüfbarkeit.

Projektstatus: 1.0.0. Überprüfen Sie die Matrix der unterstützten Operationen und validieren Sie Berechtigungen gegen ein Nicht-Produktions-New-Relic-Konto, bevor Sie Schreibvorgänge aktivieren. Die MCP-Registry, npm, Container- und MCPB-Metadaten sind vorbereitet, aber dieses Repository veröffentlicht keine Artefakte ohne Anmeldeinformationen des Betreuers.

Anforderungen

• Node.js 22.7.5 oder neuer; Node 24 LTS wird für die Produktion empfohlen.

• Ein New Relic Benutzerschlüssel mit nur den Berechtigungen, die die aktivierten Toolsets benötigen.

• Ein New Relic-Konto, das den US- oder EU-Endpunkt verwendet, oder eine verifizierte JP-Kompatibilitätsendpunkt-Bereitstellung (siehe Konfiguration).

• Ein MCP-Client, der stdio oder Streamable HTTP unterstützt.

New Relic wendet ein Limit von 25 gleichzeitigen NerdGraph-Anfragen pro Benutzer über alle Schlüssel dieses Benutzers an. Dieser Server verwendet standardmäßig insgesamt 20 Anfragen und fünf komplexe NRQL-Abfragen. Siehe Leistung und Skalierung, bevor Sie Replikate hinzufügen. Gewöhnliche HTTP-Aufrufe sind sitzungslos; eine schnelle SDK-Abbrechung über mehrere Replikate erfordert zusätzlich eine deterministische Load-Balancer-Affinität.

Schnellstart: stdio

Installieren Sie das Paket global:

npm install --global @meet-bhalodiya/newrelic-mcp
export NEW_RELIC_API_KEY='NRAK-...'
export NEW_RELIC_REGION='US'
newrelic-mcp doctor --json
newrelic-mcp

Oder lassen Sie den MCP-Client das festgelegte Paket über npx aufrufen:

NEW_RELIC_API_KEY='NRAK-...' \
  npx -y @meet-bhalodiya/newrelic-mcp@1.0.0 doctor --json

Stdio reserviert stdout für MCP-Frames. Laufzeitdiagnose und Logs gehen nach stderr.

Schnellstart: authentifiziertes HTTP

Erstellen Sie zwei Dateien, die nur für das Dienstkonto lesbar sind:

install -m 0700 -d ./secrets
printf '%s' "$NEW_RELIC_API_KEY" > ./secrets/new_relic_api_key
openssl rand -hex 32 > ./secrets/mcp_bearer_token
chmod 0400 ./secrets/*

Starten Sie einen Loopback-Container:

docker compose up --build

Der MCP-Endpunkt ist http://127.0.0.1:3000/mcp; Health-Probes sind unter /healthz und /readyz. Docker Compose aktiviert bewusst die statische Bearer-Authentifizierung. Lesen Sie das Token aus ./secrets/mcp_bearer_token und senden Sie es im Authorization: Bearer <token>-Header.

Für einen nativen Prozess:

export NEW_RELIC_API_KEY_FILE="$PWD/secrets/new_relic_api_key"
export MCP_AUTH_MODE=bearer
export MCP_BEARER_TOKEN_FILE="$PWD/secrets/mcp_bearer_token"
newrelic-mcp http --host 127.0.0.1 --port 3000

Nicht-Loopback-HTTP muss Bearer- oder OIDC-Auth, eine explizite Host-Zulassungsliste, TLS am Reverse-Proxy und eine Origin-Zulassungsliste für Browser-Clients verwenden. Siehe Bereitstellung und Sicherheit.

Client-Einrichtung

Diese kurzen Beispiele verwenden den schreibgeschützten stdio-Server. Die vollständige Anleitung enthält entfernte Bearer- und OAuth-Setups sowie client-spezifische Hinweise.

Claude Code

claude mcp add --transport stdio --scope user \
  --env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \
  --env NEW_RELIC_REGION=US \
  newrelic -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0

Verwenden Sie /mcp in Claude Code, um die Verbindung zu überprüfen.

Claude Desktop

Für die sicherste lokale Installation erstellen oder laden Sie das .mcpb-Bundle und verwenden Sie Einstellungen → Erweiterungen → Erweiterte Einstellungen → Erweiterung installieren. Claude Desktop speichert als sensibel markierte Felder in der sicheren OS-Speicherung. Ein manuelles lokales stdio JSON-Beispiel finden Sie in der Client-Konfiguration. Entfernte Server müssen über Einstellungen → Connectors hinzugefügt werden, nicht über claude_desktop_config.json.

Cursor

Kopieren Sie examples/cursor.mcp.json in .cursor/mcp.json für ein Projekt oder ~/.cursor/mcp.json global. Starten Sie Cursor aus einer Umgebung, in der NEW_RELIC_API_KEY verfügbar ist, und aktivieren Sie dann den Server unter den MCP-Einstellungen.

Codex

codex mcp add newrelic \
  --env NEW_RELIC_REGION=US \
  --env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \
  -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0
codex mcp list

Codex CLI, die Codex IDE-Erweiterung und die ChatGPT-Desktop-App auf demselben Codex-Host teilen sich config.toml. Siehe die Codex-Beispiele für Streamable HTTP Bearer- und OAuth-Modi.

CLI

newrelic-mcp [stdio]
newrelic-mcp http [--host HOST] [--port PORT]
newrelic-mcp doctor [--json]
newrelic-mcp tools [--json]

• stdio (oder kein Unterbefehl) startet den lokalen Transport.

• http bedient zustandsloses Streamable HTTP unter /mcp plus Health-Endpunkte; sein begrenztes Abbrechungsregister ist prozesslokal.

• doctor validiert Konfiguration, Anmeldeinformationen, Region, zugängliche Konten und eine begrenzte Schemaauswahl für jedes effektiv aktivierte Toolset; es führt niemals Mutationen durch oder gibt Geheimnisse aus.

• tools meldet aktivierte Toolsets und Sicherheitsgates ohne Kontaktaufnahme mit New Relic.

Sicherheitsmodell

Das Aktivieren eines Gates registriert das entsprechende Tool; es umgeht nicht die New Relic-Berechtigungen oder HTTP-Autorisierungsbereiche. Schreibvorgänge standardmäßig weiterhin auf Dry-Run. Wenden Sie die genaue Bestätigungsphrase an, die vom Dry-Run mit ansonsten identischen Argumenten zurückgegeben wird. Bestätigungsphrasen binden an die normalisierte Änderung und den Vor-Lese-Zustand; eine andere Zustandsänderung erfordert einen neuen Dry-Run.

Das Projekt schließt bewusst die Erstellung von API-Schlüsseln, synthetische Secure-Credential-Mutation, Live-Dashboard-Passwörter und -Zurücksetzungen, historische Export-URLs, Slack-Zielerstellung, beliebiges Löschen von Entitäten, Telemetrieerfassung und rohes GraphQL aus.

Toolsets und MCP-Fähigkeiten

Die standardmäßige Leseoberfläche ist in unabhängig auswählbare Toolsets unterteilt:

• core

• nrql

• entities

• alerts

• dashboards

• synthetics

• workloads

• service-levels

• logs

• metrics

• admin (niemals implizit aktiviert)

Verwenden Sie newrelic-mcp tools --json für den genauen Laufzeitkatalog und tool-catalog.md für Beschreibungen. Ressourcen umfassen Serverfähigkeiten, Konten und typisierte Entitäts-/Konfigurationsvorlagen. Statische Prompts decken Incident-Triage, Service-Health, Alarmrichtlinienüberprüfung, SLO-Überprüfung, Dashboard-Design und synthetische Fehleranalyse ab. Tools bleiben die maßgebliche universelle Schnittstelle, da Prompt- und Ressourcenunterstützung zwischen MCP-Clients variiert.

Konfiguration

Die Konfiguration wird beim Start validiert. Die wichtigsten Einstellungen sind:

NEW_RELIC_API_KEY=                  # xor NEW_RELIC_API_KEY_FILE
NEW_RELIC_REGION=US                 # US, EU, or JP
NEW_RELIC_DEFAULT_ACCOUNT_ID=
NEW_RELIC_ACCOUNT_ALLOWLIST=
NEW_RELIC_TOOLSETS=core,nrql,entities
MCP_AUTH_MODE=none                  # none, bearer, oidc

Dateibasierte Geheimnisse werden für Dienste bevorzugt und nehmen denselben Wert wie ihre Umgebungsäquivalente an. Setzen Sie nicht beide Formen. Überprüfen Sie configuration.md für Rangfolge, alle Einstellungen, Validierungsregeln und Beispiele.

Entwicklung

npm ci
npm run build
npm run lint
npm run typecheck
npm test
npm run verify
npm pack --dry-run

Lokal ausführen mit einem arbeitsbereichsspezifischen HTTP-Port:

CONDUCTOR_PORT=3100 npm run dev:http

Opt-in-Livetests erfordern ein explizites Konto und sind schreibgeschützt, es sei denn, das separate Einwegkonto-Schreibflag ist gesetzt. Siehe development.md und CONTRIBUTING.md.

Dokumentation

• Architektur

• Konfigurationsreferenz

• Tool-Katalog

• New Relic-Berechtigungen und Editionen

• Client-Konfiguration

• Bereitstellung

• Leistung

• Sicherheit und Bedrohungsmodell

• Fehlerbehebung

• Offizielle API-Quellmatrix

• Release-Prozess

• Abhängigkeitsrichtlinie

• Architekturentscheidungen

Mitwirken

Beiträge sind willkommen — Fehlerberichte, Funktionen, die durch die offizielle New Relic-Dokumentation gestützt werden, Dokumentation und Tests. Beginnen Sie mit CONTRIBUTING.md und den good first issues. Die Teilnahme erfolgt gemäß dem Verhaltenskodex.

Wenn dieses Projekt für Sie oder Ihr Team nützlich ist, hilft ein ⭐ anderen, es zu entdecken.

Support und Sicherheit

Hilfe benötigt? Siehe SUPPORT.md. Nutzen Sie GitHub Issues für reproduzierbare Fehler und Funktionsanfragen, und fügen Sie niemals New Relic-Schlüssel, Bearer-Tokens, NRQL, Kontodaten, Entitätsdetails, Rohantworten oder vorab signierte URLs ein.

Melden Sie Sicherheitslücken vertraulich gemäß SECURITY.md.

Lizenz

Apache License 2.0. Siehe LICENSE.