New Relic MCP サーバー

AI アシスタントを New Relic に安全に接続します。

プロダクション指向でセルフホスト可能な Model Context Protocol (MCP) サーバーです。Claude、Cursor、Codex、その他の MCP クライアントに、NRQL、ログ、メトリクス、トレース、エラー、エンティティ、アラート、インシデント、ダッシュボード、シンセティックス、ワークロード、サービスレベル、および選択された管理 API への、型付けされた読み取り専用（デフォルト）のアクセスを提供します。これらはすべて New Relic の NerdGraph を介して行われます。

このサーバーは、任意の GraphQL を公開したり、クライアントの認証情報を New Relic に転送したり、New Relic のキーをツールの引数として受け入れたりすることは意図的に行いません。変更操作は、その機能ゲートが明示的に有効化されていない限り存在せず、すべての書き込み操作はドライラン、確認フレーズ、書き込み後の読み返しというワークフローを使用します。

ハイライト

• 🔒 デフォルトで安全 — 初期状態では読み取り専用。書き込みはオプトインであり、ゲート制御され、ドライラン → 確認フレーズ → 書き込み後の読み返しというフローを実行します。

• 🧱 制限された API サーフェス — 固定された文書化済みの NerdGraph 操作セット。任意の GraphQL はなく、認証情報がツールの引数として渡されることもありません。

• 🔌 あらゆる MCP クライアントで動作 — Claude Code、Claude Desktop、Cursor、Codex などで、stdio またはステートレスな Streamable HTTP を介して動作します。

• 📈 使用テレメトリを内蔵 — ツールごとの呼び出し回数、所要時間、結果、さらに上流の NerdGraph、キュー深度、リトライ、レート制限、キャッシュのメトリクスを提供する Prometheus /metrics エンドポイント。

• 🏢 エンタープライズ対応 — ベアラー/OIDC 認証、ホスト/オリジン許可リスト、アカウント許可リスト、シークレットと PII の編集、Docker、Helm。

• 🧰 幅広いカバレッジ — NRQL、エンティティ、アラート、ダッシュボード、シンセティックス、ワークロード、サービスレベル、ログ、メトリクス用の独立して選択可能なツールセット。

• 📚 文書化およびテスト済み — アーキテクチャ文書、ADR、および CI ですべての変更をゲートする単体/統合/契約/セキュリティ/負荷テストスイート。

Related MCP server: New Relic MCP Server

依頼できること

接続後、MCP クライアントに平文で依頼してください。クライアントが適切な読み取り専用ツールを選択して呼び出します。

• 「過去 1 時間のチェックアウトサービスの最も遅いトランザクションは？」

• 「支払いチームのオープンインシデントとその推定原因を要約して。」

• 「今週、目標を達成するリスクがあるサービスレベルは？」

• 「アラートポリシーをレビューして、カバレッジのギャップを指摘して。」

• 「昨夜、ログインシンセティックモニターが失敗した理由は？」

完全な機能セットについては、ツールカタログ を参照してください。

この MCP の理由

New Relic は、公式の New Relic ホスト型 MCP サーバー（New Relic AI MCP、現在プレビュー中）を提供しています。このプロジェクトは、それに対する補完的な、セルフホスト可能でオープンソースの代替手段です。以下の場合に選択してください。

• セルフホスティングと制御 — 独自の認証情報を使用して、MCP ブリッジを自身のネットワーク内で実行します。送信される NerdGraph 呼び出しのみが境界外に出ます。（New Relic のプレビューは FedRAMP 規制アカウントでは提供されていません。）

• デフォルトで読み取り専用、ゲート制御された書き込み — すべての変更操作はオプトインであり、ドライラン → 確認フレーズ → 読み返しフローを実行します。

• 固定された監査可能な操作サーフェス — 文書化された NerdGraph 操作セット。任意の GraphQL はなく、New Relic のキーがツールの引数として渡されることもありません。

• 独自の制御 — ベアラー/OIDC 認証、ホスト/オリジンおよびアカウント許可リスト、シークレット編集、独立して選択可能なツールセット。

• 第一級のテレメトリ — ツールの使用状況と上流の呼び出しに関する Prometheus メトリクス。既存の可観測性スタックにスクレイピングできます。

• Apache-2.0 ライセンスでフォーク可能 — デプロイするものを検査、固定、拡張できます。

ゼロ運用で New Relic 管理のエクスペリエンスを New Relic AI と統合したい場合は、公式サーバーの方が適している可能性があります。このプロジェクトは、その利便性と引き換えに、セルフホスティング、制御、および監査可能性を提供します。

プロジェクトステータス: 1.0.0。書き込みを有効にする前に、サポート対象操作マトリックス を確認し、非本番 New Relic アカウントに対して権限を検証してください。MCP レジストリ、npm、コンテナ、MCPB メタデータは準備されていますが、このリポジトリはメンテナーの認証情報なしではアーティファクトを公開しません。

要件

• Node.js 22.7.5 以降。本番環境では Node 24 LTS を推奨。

• 有効化されたツールセットに必要な権限のみを持つ New Relic ユーザーキー。

• US または EU エンドポイントを使用する New Relic アカウント、または検証済みの JP 互換性エンドポイントデプロイメント（設定 を参照）。

• stdio または Streamable HTTP をサポートする MCP クライアント。

New Relic は、そのユーザーが所有するすべてのキーに対して、ユーザーあたり 25 の同時 NerdGraph リクエストという制限を適用します。このサーバーは、デフォルトで合計 20 リクエスト、5 つの複雑な NRQL クエリに設定されています。レプリカを追加する前に、パフォーマンスとスケーリング を参照してください。通常の HTTP 呼び出しはセッションレスです。複数のレプリカにわたるプロンプト SDK のキャンセルには、さらに決定論的なロードバランサーのアフィニティが必要です。

クイックスタート: stdio

パッケージをグローバルにインストールします。

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

または、MCP クライアントに npx を介して固定されたパッケージを呼び出させます。

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

Stdio は MCP フレーム用に stdout を予約します。ランタイム診断とログは stderr に出力されます。

クイックスタート: 認証付き HTTP

サービスアカウントのみが読み取り可能な 2 つのファイルを作成します。

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

ループバック専用コンテナを起動します。

docker compose up --build

MCP エンドポイントは http://127.0.0.1:3000/mcp です。ヘルスチェックは /healthz と /readyz にあります。Docker Compose は意図的に静的ベアラー認証を有効にします。./secrets/mcp_bearer_token からトークンを読み取り、Authorization: Bearer <token> で送信します。

ネイティブプロセスの場合:

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

非ループバック HTTP は、ベアラーまたは OIDC 認証、明示的なホスト許可リスト、リバースプロキシでの TLS、およびブラウザクライアント用のオリジン許可リストを使用する必要があります。デプロイメント と セキュリティ を参照してください。

クライアント設定

これらの短い例では、読み取り専用の stdio サーバーを使用します。完全なガイドには、リモートベアラーおよび OAuth のセットアップと、クライアント固有の注意事項が含まれています。

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

Claude Code 内で /mcp を使用して接続を確認します。

Claude Desktop

最も安全なローカルインストールのために、.mcpb バンドルをビルドまたはダウンロードし、設定 → 拡張機能 → 詳細設定 → 拡張機能をインストール を使用してください。Claude Desktop は、機密としてマークされたフィールドを OS のセキュアストレージに保存します。手動のローカル stdio JSON の例は、クライアント設定 にあります。リモートサーバーは、claude_desktop_config.json ではなく、設定 → コネクタ から追加する必要があります。

Cursor

examples/cursor.mcp.json を、プロジェクトごとに .cursor/mcp.json に、またはグローバルに ~/.cursor/mcp.json にコピーします。NEW_RELIC_API_KEY が利用可能な環境から Cursor を起動し、MCP 設定でサーバーを有効にします。

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、Codex IDE 拡張機能、および同じ Codex ホスト上の ChatGPT デスクトップアプリは、config.toml を共有します。Streamable HTTP ベアラーおよび OAuth モードについては、Codex の例 を参照してください。

CLI

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

• stdio（またはサブコマンドなし）はローカルトランスポートを起動します。

• http は、/mcp でセッションレスな Streamable HTTP とヘルスエンドポイントを提供します。その制限付きキャンセルレジストリはプロセスローカルです。

• doctor は、設定、認証情報、リージョン、アクセス可能なアカウント、および実質的に有効化されたすべてのツールセットに対して 1 つの制限付き固定クエリスキーマを検証します。変更操作を発行したり、シークレットを出力したりすることはありません。

• tools は、New Relic に問い合わせることなく、有効化されたツールセットとセーフティゲートを報告します。

セーフティモデル

ゲートを有効にすると、対応するツールが登録されます。New Relic の権限や HTTP 認証スコープがバイパスされるわけではありません。書き込みはデフォルトでドライランになります。ドライランによって返された正確な確認フレーズを、それ以外は同一の引数で適用します。確認フレーズは、正規化された変更と事前読み取り状態にバインドされます。別の状態変更には、新しいドライランが必要です。

このプロジェクトは、API キーの作成、シンセティックセキュアクレデンシャルの変更、ライブダッシュボードのパスワードとリセット、履歴エクスポート URL、Slack 送信先の作成、任意のエンティティの削除、テレメトリ取り込み、および生の GraphQL を意図的に除外しています。

ツールセットと MCP 機能

デフォルトの読み取りサーフェスは、独立して選択可能なツールセットに分割されています。

• core

• nrql

• entities

• alerts

• dashboards

• synthetics

• workloads

• service-levels

• logs

• metrics

• admin（暗黙的に有効になることはありません）

正確なランタイムカタログについては newrelic-mcp tools --json を、説明については tool-catalog.md を参照してください。リソースには、サーバー機能、アカウント、型付けされたエンティティ/設定テンプレートが含まれます。静的プロンプトは、インシデントトリアージ、サービスヘルス、アラートポリシーレビュー、SLO レビュー、ダッシュボード設計、シンセティック障害分析をカバーします。プロンプトとリソースのサポートは MCP クライアントによって異なるため、ツールは信頼できるユニバーサルインターフェースであり続けます。

設定

設定は起動時に検証されます。最も重要な設定は次のとおりです。

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

ファイルベースのシークレットはサービスに推奨され、環境変数と同じ値を取ります。両方の形式を設定しないでください。優先順位、すべての設定、検証ルール、および例については、configuration.md を参照してください。

開発

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

ワークスペース固有の HTTP ポートでローカル実行します。

CONDUCTOR_PORT=3100 npm run dev:http

オプトインのライブテストには明示的なアカウントが必要であり、別の使い捨てアカウント書き込みフラグが設定されていない限り読み取り専用です。development.md と CONTRIBUTING.md を参照してください。

ドキュメント

• アーキテクチャ

• 設定リファレンス

• ツールカタログ

• New Relic の権限とエディション

• クライアント設定

• デプロイメント

• パフォーマンス

• セキュリティと脅威モデル

• トラブルシューティング

• 公式 API ソースマトリックス

• リリースプロセス

• 依存関係ポリシー

• アーキテクチャ上の決定

コントリビューション

コントリビューションを歓迎します — バグ報告、New Relic公式ドキュメントに基づく機能、ドキュメント、テストなど。まずはCONTRIBUTING.mdとgood first issuesをご確認ください。すべての参加はCode of Conductに従います。

このプロジェクトがあなたやチームにとって有用であれば、⭐ を付けていただけると他の人にも役立ちます。

サポートとセキュリティ

ヘルプが必要ですか？SUPPORT.mdをご覧ください。GitHub Issuesでは再現可能なバグや機能リクエストをご報告ください。New Relicのキー、ベアラートークン、NRQL、アカウントデータ、エンティティ詳細、生のレスポンス、署名付きURLは絶対に含めないでください。

脆弱性はSECURITY.mdに従って非公開で報告してください。

ライセンス

Apache License 2.0。詳しくはLICENSEをご覧ください。