New Relic MCP 服务器

一个简单的模型上下文协议 (MCP) 服务器，用于使用 NRQL 查询 New Relic 日志。此服务器使大型语言模型 (LLM)，如 Claude，能够与您的 New Relic 数据交互。

功能

• 使用 NRQL 查询 New Relic 日志和指标
• 详细的错误日志记录
• 轻松与 Claude Desktop 集成
• 人类可读的输出格式
• 可配置的 New Relic 帐户 ID

安装说明

前提条件

• Python 3.10 或更高版本
• New Relic 帐户和 API 密钥
• Claude Desktop 应用程序

安装步骤

1. 安装 uv 包管理器：

# On macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# On 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  # On Unix/macOS
.venv\Scripts\activate     # On Windows

# 安装依赖
uv pip install "mcp[cli]" httpx

3. 使用提供的代码创建服务器文件 newrelic_logs_server.py。

4. 配置您的环境变量：

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

# On Windows (CMD)
set NEW_RELIC_API_KEY=your-api-key-here
set NEW_RELIC_ACCOUNT_ID=your-account-id-here

# On 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"
            ],
            "env": {
                "NEW_RELIC_API_KEY": "your-api-key-here",
                "NEW_RELIC_ACCOUNT_ID": "your-account-id-here"
            }
        }
    }
}

用法

NRQL 查询示例

1. 基本事务查询：

SELECT * FROM Transaction SINCE 1 hour ago

2. 错误分析：

SELECT * FROM Transaction WHERE error IS TRUE SINCE 1 hour ago LIMIT 10

3. 性能分析：

SELECT average(duration) FROM Transaction FACET name ORDER BY average(duration) DESC LIMIT 5

Claude 提示示例

您可以向 Claude 提出如下问题：

• "Show me all transactions from the last hour" (显示过去一小时内的所有事务)
• "Are there any errors in our application?" (我们的应用程序中是否有任何错误？)
• "What are our slowest endpoints?" (我们最慢的端点是什么？)

调试

查看日志

# On macOS/Linux
tail -f ~/Library/Logs/Claude/mcp-server-newrelic.log

# On Windows
type %APPDATA%\Claude\logs\mcp-server-newrelic.log

使用 MCP Inspector 进行测试

使用以下命令测试您的服务器功能：

npx @modelcontextprotocol/inspector uv run newrelic_logs_server.py

常见问题

1. 身份验证错误：

• 检查 NEW_RELIC_API_KEY 是否设置正确
• 验证 API 密钥是否具有正确的权限
• 确保 API 密钥有效

2. 查询错误：

• 验证 NRQL 语法
• 检查代码中的帐户 ID 是否与您的帐户匹配
• 确保查询的数据存在于时间范围内

3. 连接问题：

• 检查网络连接
• 验证 GraphQL 端点是否可访问
• 确保没有防火墙阻止连接

安全注意事项

• 永远不要将 API 密钥提交到版本控制
• 使用环境变量存储敏感数据
• 保持依赖项更新
• 监控查询模式和访问日志

开发

本地测试

1. 设置环境变量：

export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"

2. 运行服务器：

uv run newrelic_logs_server.py

代码结构

该服务器实现：

• 单个 NRQL 查询工具
• 可配置的 New Relic 帐户 ID
• 完善的错误处理
• 详细的日志记录
• 响应格式化

测试更改

1. 根据需要修改代码
2. 使用 MCP Inspector 进行测试
3. 重新启动 Claude Desktop 以应用更改

故障排除指南

1. 服务器未启动：

• 检查 Python 版本
• 验证是否已安装所有依赖项
• 确保虚拟环境已激活

2. 查询不起作用：

• 检查日志以获取详细的错误消息
• 验证 NRQL 语法
• 确保数据存在于查询的时间范围内

3. Claude 无法连接：

• 验证配置文件语法
• 检查路径是否为绝对路径
• 重新启动 Claude Desktop

贡献

1. Fork 存储库
2. 创建一个功能分支
3. 提交一个 pull request

许可证

该项目根据 MIT 许可证获得许可。

支持

如果您遇到问题：

1. 检查日志
2. 查看常见问题部分
3. 使用 MCP Inspector 进行测试
4. 在 GitHub 上提交一个 issue