New Relic MCP Server

New Relic MCP Server

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 エンドポイントがあります。
• 🏢 エンタープライズ対応 — Bearer/OIDC 認証、Host/Origin 許可リスト、アカウント許可リスト、シークレットと PII のマスキング、Docker、Helm に対応しています。
• 🧰 幅広いカバレッジ — NRQL、エンティティ、アラート、ダッシュボード、シンセティック、ワークロード、サービスレベル、ログ、メトリクスのツールセットを個別に選択できます。
• 📚 ドキュメントとテストが充実 — アーキテクチャドキュメント、ADR、ユニット／インテグレーション／コントラクト／セキュリティ／負荷テストのスイートを備え、CI ですべての変更を検証します。

できること

接続したら、MCP クライアントに自然な言葉で質問してください。適切な読み取り専用ツールを選んで呼び出します。

• 「過去1時間で、チェックアウトサービスの最も遅いトランザクションは何ですか？」
• 「決済チームの未解決インシデントと、考えられる原因を要約してください。」
• 「今週、目標を達成できないリスクがあるサービスレベルはどれですか？」
• 「アラートポリシーを確認して、カバレッジの不足箇所を指摘してください。」
• 「夜間にログインのシンセティックモニターが失敗したのはなぜですか？」

機能の全一覧については、ツールカタログをご覧ください。

この MCP を選ぶ理由

New Relic では、New Relic がホストする公式 MCP サーバー （New Relic AI MCP。現在は プレビュー版）が提供されています。このプロジェクトは、これを補完するセルフホスト可能なオープンソース の代替手段です。次のような場合にお選びください。

• セルフホストと制御 — MCP ブリッジを独自のネットワーク内で、独自の認証情報を使って実行できます。境界の外に出るのはアウトバウンドの NerdGraph 呼び出しのみです。（New Relic のプレビュー版は、FedRAMP 規制対象アカウントでは利用できません。）
• デフォルトは読み取り専用、書き込みは制御下で実行 — すべての変更操作はオプトインで、ドライラン → 確認フレーズ → 読み戻しのフローで実行されます。
• 固定され、監査可能な操作範囲 — 任意の GraphQL を使わず、ツール引数として New Relic キーを渡さない、文書化された NerdGraph 操作のセットです。
• 独自の制御機能 — ベアラー／OIDC 認証、Host／Origin とアカウントの許可リスト、シークレットのマスキング、個別に選択可能なツールセットを備えています。
• テレメトリーを第一級でサポート — ツールの使用状況とアップストリーム呼び出しの Prometheus メトリクスを、既存の可観測性スタックにスクレイプできます。
• Apache-2.0 ライセンスでフォーク可能 — デプロイするものを正確に調査、固定、拡張できます。

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

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

要件

• Node.js 22.7.5 以降。本番環境には Node 24 LTS を推奨します。
• 有効にするツールセットに必要な権限のみを持つ New Relic ユーザーキー。
• US または EU エンドポイントを使用する New Relic アカウント、または検証済みの JP 互換エンドポイントのデプロイメント（設定を参照）。
• stdio または Streamable HTTP に対応した MCP クライアント。

New Relic では、1 人のユーザーが所有するすべてのキーを対象に、ユーザーごとに同時 NerdGraph リクエスト数の上限が 25 に設定されています。このサーバーでは、リクエスト総数のデフォルトを 20、複雑な NRQL クエリ数のデフォルトを 5 としています。レプリカを追加する前に、パフォーマンスとスケーリングを確認してください。通常の 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/[email protected] doctor --json

stdio では stdout を MCP フレーム用に予約しています。実行時の診断情報とログは 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 認証、明示的な Host 許可リスト、リバースプロキシでの TLS、ブラウザークライアント用の Origin 許可リストが必要です。デプロイとセキュリティを参照してください。

クライアントの設定

以下の短い例では、読み取り専用の 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/[email protected]

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

Claude Desktop

最も安全なローカルインストール方法は、.mcpb バンドルをビルドまたはダウンロードし、Settings → Extensions → Advanced settings → Install Extension を使用することです。Claude Desktop は、機密情報としてマークされたフィールドを OS のセキュアストレージに保存します。手動で設定するローカル stdio JSON の例は、クライアント設定を参照してください。リモートサーバーは、claude_desktop_config.json ではなく、Settings → Connectors から追加する必要があります。

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/[email protected]
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 では、設定、認証情報、リージョン、アクセス可能なアカウント、および実質的に有効な各ツールセットに対する、上限付きの固定クエリによるスキーマ選択を検証します。変更操作を実行したり、シークレットを表示したりすることはありません。
• tools では、New Relic に接続せずに、有効なツールセットと安全性ゲートを表示します。

安全性モデル

機能	デフォルト	必要な設定
読み取りツール	選択したツールセットに応じて有効	NEW_RELIC_TOOLSETS
通常の書き込み	無効	NEW_RELIC_ENABLE_WRITES=true
削除、キャンセル、取り消し、置換更新、公開、抑制	無効	書き込みに加えて NEW_RELIC_ENABLE_DESTRUCTIVE=true
組織管理	無効	NEW_RELIC_ENABLE_ADMIN=true および適切な認証スコープ
プレビュー版のデータ管理 API	無効	NEW_RELIC_ENABLE_PREVIEW_APIS=true
実験的な AI イシュー操作	無効	NEW_RELIC_ENABLE_EXPERIMENTAL_AI_ISSUES=true

ゲートを有効にすると、対応するツールが登録されます。New Relic の権限や HTTP 認証スコープを回避するものではありません。書き込みは引き続きデフォルトでドライランになります。ドライランで返された正確な確認フレーズを、引数を同一に保ったまま適用してください。確認フレーズは、正規化された変更内容と読み取り前の状態に紐付けられます。別の状態変更があった場合は、新たにドライランを実行する必要があります。

このプロジェクトでは、API キーの作成、Synthetic のセキュア認証情報の変更、ライブダッシュボードのパスワードとそのリセット、過去データのエクスポート 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と 初めてのコントリビューションに適した課題から始めてください。 すべての参加者は行動規範に従うものとします。

このプロジェクトがご自身やチームに役立った場合は、⭐を付けていただくと、ほかの人にも見つけてもらいやすくなります。

サポートとセキュリティ

サポートが必要な場合は、SUPPORT.mdを参照してください。 再現可能なバグや機能リクエストには GitHub Issuesを使用してください。また、New Relic のキー、ベアラートークン、NRQL、 アカウントデータ、エンティティの詳細、生のレスポンス、署名付き URL を決して含めないでください。

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

ライセンス

Apache License 2.0。LICENSEを参照してください。