New Relic Logs

🚀 新 relic MCP サーバー

このサーバーは、シンプルなモデルコンテキストプロトコル（MCP）サーバーで、NRQL を使用して New Relic のログをクエリできます。Claude などの大規模言語モデル（LLMs）が、あなたの New Relic データと相互作用できるようになります。

✨ 主な機能

• NRQL を使用して New Relic のログと指標をクエリする
• 詳細なエラーログ記録
• Claude Desktop との簡単な統合
• 人間が読みやすい出力形式
• 設定可能な New Relic アカウント ID

📦 インストール

前提条件

• Python 3.10 以上
• New Relic アカウントと API キー
• Claude Desktop アプリケーション

インストール手順

1. uv パッケージマネージャーをインストールします。

# macOS/Linux の場合
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows（PowerShell）の場合
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. プロジェクトを作成し、設定します。

# ディレクトリを作成
mkdir newrelic-mcp
cd newrelic-mcp

# 仮想環境を作成
uv venv

# 仮想環境をアクティブ化
source .venv/bin/activate  # Unix/macOS の場合
.venv\Scripts\activate     # Windows の場合

# 依存関係をインストール
uv pip install "mcp[cli]" httpx

3. サーバーファイル newrelic_logs_server.py を作成し、提供されたコードを使用します。

4. 環境変数を設定します。

# Unix/macOS の場合
export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"

# Windows（CMD）の場合
set NEW_RELIC_API_KEY=your-api-key-here
set NEW_RELIC_ACCOUNT_ID=your-account-id-here

# Windows（PowerShell）の場合
$env:NEW_RELIC_API_KEY = "your-api-key-here"
$env:NEW_RELIC_ACCOUNT_ID = "your-account-id-here"

Claude Desktop との統合

Claude Desktop を設定するには、設定ファイルを編集します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します。

{
    "mcpServers": {
        "newrelic": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/newrelic-mcp",
                "run",
                "newrelic_logs_server.py"
            ]
        }
    }
}

💻 使用例

基本的な使用法

ターミナルで以下のコマンドを実行して、サーバーをテストします。

uv run newrelic_logs_server.py

その後、以下の NRQL クエリを使用して、ログデータを取得できます。

SELECT * FROM your_log_table WHERE timestamp > NOW - 1h

📚 ドキュメント

デバッグ

ログの確認

サーバーのログとエラー情報を確認するには、コンソール出力をチェックします。

設定の検証

newrelic_logs_server.py ファイルがプロジェクトのルートディレクトリにあり、環境変数が正しく設定されていることを確認します。

セキュリティに関する注意事項

• API キーの安全性を確保し、公開コードやログに露出させないでください。
• セキュリティホールを防ぐため、依存関係を定期的に更新してください。

開発

コードの変更

1. newrelic_logs_server.py ファイル内のコードを必要に応じて変更します。
2. MCP Inspector を使用して、変更の影響をテストします。

トラブルシューティングガイド

サーバーが起動しない場合

• Python バージョンが正しいことを確認します。
• すべての依存関係がインストールされていることを確認します。
• 仮想環境がアクティブ化されていることを確認します。

クエリが機能しない場合

• ログ内の詳細なエラー情報を確認します。
• NRQL 構文の正しさを検証します。
• クエリの時間範囲内にデータが存在することを確認します。

貢献

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. プルリクエストを送信します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

サポート

問題が発生した場合は、以下の手順を試してください。

1. ログを確認します。
2. よくある質問のセクションを参照します。
3. MCP Inspector を使用してテストします。
4. GitHub で問題を報告します。