新 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 上报告问题