](https://mseep.ai/app/ivlad003-mcp-newrelic)
New Relic MCP服务器
用于使用NRQL查询查询New Relic日志的模型上下文协议（MCP）服务器。此服务器允许像Claude这样的大型语言模型（LLM）与您的New Relic数据进行交互。
Claude Code用户： 也可作为带有斜线命令、技能和调查代理的可安装插件提供——不需要MCP服务器。 安装方式：/plugin marketplace add Ivlad003/plugins然后/plugin install newrelic-observability@ivlad-plugins看 Ivlad003/插件 了解详情。
特性
- 使用NRQL查询新的Relic日志和指标
- 详细的错误记录
- 与Claude Desktop轻松集成
- 人类可读的输出格式
- 可配置的新Relic帐户ID
安装说明
先决条件
- Python 3.10或更高版本
- 新Relic帐户和API密钥
- Claude桌面应用程序
安装步骤
- 安装
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"- 创建和设置项目：
# Create directory
mkdir newrelic-mcp
cd newrelic-mcp
# Create virtual environment
uv venv
# Activate virtual environment
source .venv/bin/activate # On Unix/macOS
.venv\Scripts\activate # On Windows
# Install dependencies
uv pip install "mcp[cli]" httpx- 创建服务器文件
newrelic_logs_server.py使用提供的代码。
- 配置环境变量：
# 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桌面集成
通过编辑配置文件配置Claude Desktop：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%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查询示例
- 基本交易查询：
SELECT * FROM Transaction SINCE 1 hour ago- 错误分析：
SELECT * FROM Transaction WHERE error IS TRUE SINCE 1 hour ago LIMIT 10- 性能分析：
SELECT average(duration) FROM Transaction FACET name ORDER BY average(duration) DESC LIMIT 5克劳德提示示例
你可以问克劳德这样的问题：
- “显示最近一小时的所有交易”
- “我们的申请中有错误吗？”
- “我们最慢的端点是什么？”
调试
查看日志
# On macOS/Linux
tail -f ~/Library/Logs/Claude/mcp-server-newrelic.log
# On Windows
type %APPDATA%\Claude\logs\mcp-server-newrelic.logMCP检验员测试
使用以下工具测试服务器功能：
npx @modelcontextprotocol/inspector uv run newrelic_logs_server.py常见问题
- 身份验证错误：
- 检查NEW_RELIC_API_KEY设置是否正确
- 验证API密钥是否具有正确的权限
- 确保API密钥有效
- 查询错误：
- 验证NRQL语法
- 检查代码中的帐户ID是否与您的帐户匹配
- 确保查询的数据存在于时间范围内
- 连接问题：
- 检查网络连接
- 验证GraphQL端点是否可访问
- 确保没有防火墙阻止连接
安全须知
- 永远不要将API密钥提交到版本控制
- 对敏感数据使用环境变量
- 保持依赖关系更新
- 监控查询模式和访问日志
发展
本地测试
- 设置环境变量：
export NEW_RELIC_API_KEY="your-api-key-here"
export NEW_RELIC_ACCOUNT_ID="your-account-id-here"- 运行服务器：
uv run newrelic_logs_server.py代码结构
服务器实现：
- 单一NRQL查询工具
- 可配置的新Relic帐户ID
- 全面的错误处理
- 详细日志记录
- 响应格式
测试更改
- 根据需要修改代码
- 使用MCP检查员进行测试
- 重新启动Claude Desktop以应用更改
故障排除指南
- 服务器未启动：
- 检查Python版本
- 验证是否已安装所有依赖项
- 确保虚拟环境已激活
- 查询不起作用：
- 检查日志以获取详细的错误消息
- 验证NRQL语法
- 确保数据存在于查询的时间范围内
- 克劳德未连接：
- 验证配置文件语法
- 检查路径是否为绝对路径
- 重新启动克劳德桌面
贡献
- 分叉存储库
- 创建要素分支
- 提交拉取请求
许可证
该项目根据MIT许可证获得许可。
支持
如果您遇到问题：
- 检查日志
- 查看常见问题部分
- 使用MCP检查员进行测试
- 在GitHub上提交问题