New Relic Logs

🚀 新 relic MCP 服務器

這是一個簡單的模型上下文協議（MCP）服務器，可使用 NRQL 查詢 New Relic 日誌。該服務器讓大型語言模型（LLMs），如 Claude，能夠與您的 New Relic 數據進行交互。

✨ 主要特性

• 可使用 NRQL 查詢 New Relic 日誌和指標。
• 具備詳細的錯誤日誌記錄功能。
• 便於集成 Claude Desktop。
• 輸出格式為人類可讀形式。
• 新 relic 賬戶 ID 可配置。

📦 安裝指南

先決條件

• Python 3.10 或更高版本。
• 新 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 上報告問題。