New Relic MCP Server

New Relic MCP サーバー

New Relic のオブザーバビリティプラットフォームとシームレスに統合する Model Context Protocol（MCP）サーバーです。メトリクスのクエリ、アラートの管理、アプリケーションの監視を行い、シンプルで統一されたインターフェースからオブザーバビリティスタック全体を操作できます。

免責事項：これは非公式のコミュニティプロジェクトであり、New Relic, Inc. との提携、承認、サポートはありません。すべての商標はそれぞれの所有者に帰属します。

機能

• 📊 NRQL クエリ - データを分析するための強力なクエリを実行します
• 🚀 APM 統合 - アプリケーションのパフォーマンスと健全性を監視します
• 🔔 アラート管理 - アラートやインシデントを表示し、確認します
• 🔍 エンティティ検索 - インフラストラクチャ全体のエンティティを見つけて調査します
• 📈 Synthetics モニタリング - 合成モニターとチェックを管理します
• 🔧 NerdGraph API - New Relic の GraphQL API に直接アクセスします
• 🌐 REST v2 ツール（2.0 以降） - デプロイ、APM アプリ、メトリクス、アラート向けの価値の高い REST エンドポイント

インストール

Smithery で簡単にインストール

Smithery 経由でインストールまたはデプロイする方法については、公式ドキュメントをご覧ください：デプロイ、プロジェクトの設定、smithery.yaml リファレンス。

Smithery 経由で Claude Desktop に New Relic MCP を自動インストールするには：

npx @smithery/cli install @cloudbring/newrelic-mcp --client claude

Smithery CLI（推奨）

ローカルでの開発、検査、デプロイのワークフローには Smithery CLI をおすすめします。利点：

• クライアントに依存しない、統合された開発／ビルド／デプロイのワークフロー
• ホットリロードとプレイグラウンドを備えた開発サーバー（オプションのトンネル）
• stdio または shttp トランスポート用のビルドバンドル
• サーバーを対話形式で検査し、指定された設定で実行
• クライアントごとのシンプルなインストール

例：

# Hot‑reload dev server
npx @smithery/cli dev src/server.ts --port 8181 --no-open

# Build production bundle (shttp transport)
npx @smithery/cli build src/server.ts --out .smithery/index.cjs --transport shttp

# Inspect a published server
npx @smithery/cli inspect @cloudbring/newrelic-mcp

# Run with config (env via JSON)
npx @smithery/cli run @cloudbring/newrelic-mcp --config '{"NEW_RELIC_API_KEY":"...","NEW_RELIC_ACCOUNT_ID":"...","NEW_RELIC_REGION":"US"}'

# Install into a specific client
npx @smithery/cli install newrelic-mcp --client claude

# Open playground
npx @smithery/cli playground --port 3001

注：

• このリポジトリには、TypeScript を優先するデプロイに合わせて、runtime: "typescript" を指定した最小限の smithery.yaml が含まれています。
• すべてのコマンドとフラグについては、CLI リファレンスをご覧ください：smithery-ai/cli。

手動インストール

{
  "mcpServers": {
    "newrelic": {
      "command": "npx",
      "args": [
        "-y",
        "newrelic-mcp"
      ],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

{
  "cline.mcpServers": [
    {
      "name": "newrelic",
      "command": "npx",
      "args": ["-y", "newrelic-mcp"],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  ]
}

{
  "language_models": {
    "mcp": {
      "servers": {
        "newrelic": {
          "command": "npx",
          "args": ["-y", "newrelic-mcp"],
          "env": {
            "NEW_RELIC_API_KEY": "your-api-key-here",
            "NEW_RELIC_ACCOUNT_ID": "your-account-id"
          }
        }
      }
    }
  }
}

{
  "mcpServers": {
    "newrelic": {
      "command": "npx",
      "args": ["-y", "newrelic-mcp"],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

git clone https://github.com/cloudbring/newrelic-mcp.git
cd newrelic-mcp

npm install
npm run build

{
  "mcpServers": {
    "newrelic": {
      "command": "node",
      "args": ["/path/to/newrelic-mcp/dist/server.js"],
      "env": {
        "NEW_RELIC_API_KEY": "your-api-key-here",
        "NEW_RELIC_ACCOUNT_ID": "your-account-id",
        "NEW_RELIC_REGION": "US"
      }
    }
  }
}

設定

必須の環境変数

• NEW_RELIC_API_KEY - New Relic のユーザー API キー（必須）
• NEW_RELIC_ACCOUNT_ID - New Relic のアカウント ID（任意。ツール呼び出しごとに指定できます）
• NEW_RELIC_REGION - New Relic のデータセンターリージョン：US（デフォルト）または EU（任意）

New Relic 認証情報の取得

1. API キー:

   • New Relic にログインします
   • 左側のサイドバーで API Keys に移動します
   • 適切な権限を持つ新しいユーザー API キーを作成します

2. アカウント ID:

   • New Relic にログインした状態で、URLからアカウント ID を確認します
   • または、Administration → Access management → Accounts に移動します

3. リージョン:

   • 米国のデータセンターでは NEW_RELIC_REGION=US を設定します（デフォルト）
   • EU のデータセンターでは NEW_RELIC_REGION=EU を設定します
   • 指定しない場合は、デフォルトで US になります

詳細なセットアップ手順については、docs/new-relic-setup.md を参照してください。

使用例

設定が完了すると、MCP クライアントを通じて New Relic を操作できます。

データのクエリ

"Show me the average response time for my web application over the last hour"
"What are the top 10 slowest database queries today?"
"Display error rate trends for the production environment"

アプリケーションの監視

"List all my APM applications and their current status"
"Show me the health of my Node.js services"
"Which applications have active alerts?"

アラートの管理

"Show me all open incidents"
"What critical alerts fired in the last 24 hours?"
"Acknowledge incident #12345"

インフラストラクチャの検索

"Find all Redis databases in production"
"Show me entities with high CPU usage"
"List all synthetic monitors and their success rates"

ツールリファレンス

以下は、このサーバーが公開するすべての MCP ツールの簡潔な一覧です。詳細な説明と仕様については、docs フォルダーを参照してください。

NerdGraph/GraphQL ツール

REST v2 ツール（v2.0 で追加）

参照先：

• 詳細な仕様とスキーマ：docs/REST_ENDPOINT_TOOL.md および docs/rest-tools-stories/*

トラブルシューティング

開発

プロジェクト構成

src/
├── server.ts           # Main MCP server implementation
├── client/
│   └── newrelic-client.ts  # New Relic API client
└── tools/
    ├── nrql.ts         # NRQL query tool
    ├── apm.ts          # APM applications tool
    ├── entity.ts       # Entity management tools
    ├── alert.ts        # Alert and incident tools
    ├── synthetics.ts   # Synthetics monitoring tools
    └── nerdgraph.ts    # NerdGraph query tool

開発環境のセットアップ

1. リポジトリをクローンします：

git clone https://github.com/cloudbring/newrelic-mcp.git
cd newrelic-mcp

2. 依存関係をインストールします：

npm install

3. .env ファイルを作成します：

NEW_RELIC_API_KEY=your-api-key-here
NEW_RELIC_ACCOUNT_ID=your-account-id
NEW_RELIC_REGION=US

4. プロジェクトをビルドします：

npm run build

開発コマンド

# Start development server with hot reload
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run linting
npm run lint

# Format code
npm run format

# Test server startup
npm run test:server

テスト

このプロジェクトでは、以下を使用したテスト駆動開発（TDD）を採用しています：

• Vitest によるユニットテスト
• Gherkin による BDD テスト
• Evalite による LLM レスポンスの検証

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Run BDD tests only
npm run test:bdd

# Run integration tests with real API
USE_REAL_ENV=true npm test

デバッグ

MCP Inspector を使用して、サーバーをテストおよびデバッグします：

# Run with MCP Inspector
npm run inspect

# Run with development server
npm run inspect:dev

# Run with environment variables
npm run inspect:env

詳しい手順については、docs/mcp-inspector-setup.md をご覧ください。

アーキテクチャ

このサーバーは、以下のモジュール型アーキテクチャに従っています：

• クライアント層：New Relic API との通信を処理します
• ツール層：MCP ツールの仕様を実装します
• サーバー層：MCP プロトコルとツールのルーティングを管理します

各ツールは次のとおりです：

• 単一の明確な目的を持ちます
• Zod スキーマを使用して入力を検証します
• 構造化された型付きレスポンスを返します
• 包括的なエラーハンドリングを備えています

貢献

貢献を歓迎します！詳しくは、貢献ガイドラインをご覧ください。

開発ワークフロー

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 先にテストを書きます（TDD アプローチ）
4. 機能を実装します
5. すべてのテストに合格することを確認します（npm test）
6. コードカバレッジを 90% 超に維持します
7. リンティングを実行します（npm run lint）
8. 変更をコミットします（コミットは自動的にフォーマットされます）
9. ブランチにプッシュします
10. プルリクエストを作成します

コードスタイル

このプロジェクトでは、以下を使用しています：

• Biome によるリンティングとフォーマット
• TypeScript の strict モード
• インデントには スペース 2 個
• 文字列には シングルクォート
• セミコロンは常に使用

ドキュメント

• New Relic セットアップガイド - 認証情報の詳細なセットアップ
• MCP Inspector のセットアップ - テストとデバッグ
• ログとテレメトリー - テストのモニタリング
• 実装の詳細 - アーキテクチャの詳細
• REST ツールの概要 - REST v2 ツールのハイレベルな設計
• REST ツールの仕様 - ツールごとの仕様、スキーマ、テスト計画

比較

他の公開されている New Relic MCP サーバーを調査しましたが、執筆時点では、積極的にメンテナンスされている機能完備の代替手段は見つかりませんでした。ご存じのものがあれば、ここに追加するため、イシューを作成してください。

予定している改善（REST v2 カタログとユーザーの需要に基づく）：

• アラート：利用可能な場合、REST 経由で違反と条件を管理
• メトリクス：ホスト単位に加え、アプリ単位のより幅広いメトリクスエンドポイント（名前／データ）
• REST 対応範囲の拡大：ラベル、キー・トランザクション、モバイルアプリ（フィードバックに基づいて優先順位付け）

サポート

• 🐛 バグを報告
• 💡 機能をリクエスト
• 💬 ディスカッションに参加
• 📖 ドキュメントを読む

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

免責事項

このプロジェクトは New Relic, Inc. と提携、承認、またはサポートされていません。New Relic の公開 API を使用する、独立したオープンソースプロジェクトです。

謝辞

• Model Context Protocol の仕様に基づいて構築されています
• New Relic のオブザーバビリティプラットフォーム API と統合されています
• より広範な MCP エコシステムから着想を得ています

Cursor と Claude Code を使用して、@cloudbring が ❤️ を込めて作成しました