newrelic mcp服务器
NewRelic的综合MCP服务器，有25个工具用于查询、监控和分析您的可观察性数据——NRQL、实体、警报、仪表板、日志等。
](https://www.npmjs.com/package/@ruminaider/newrelic-mcp-server) 
快速开始
使用npx
添加到您的 .mcp.json:
{
"mcpServers": {
"newrelic": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@ruminaider/newrelic-mcp-server"],
"env": {
"NEW_RELIC_API_KEY": "NRAK-XXXXXXXXXXXX",
"NEW_RELIC_ACCOUNT_ID": "1234567"
}
}
}
}使用Docker
docker build -t newrelic-mcp-server .{
"mcpServers": {
"newrelic": {
"type": "stdio",
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "NEW_RELIC_API_KEY", "-e", "NEW_RELIC_ACCOUNT_ID", "-e", "NEW_RELIC_REGION", "newrelic-mcp-server"],
"env": {
"NEW_RELIC_API_KEY": "NRAK-XXXXXXXXXXXX",
"NEW_RELIC_ACCOUNT_ID": "1234567",
"NEW_RELIC_REGION": "US"
}
}
}
}认证
服务器通过NewRelic进行身份验证 用户API密钥 （建议使用许可证密钥）：
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
NEW_RELIC_API_KEY | 是 | - | 用户API密钥（格式： NRAK-XXXXXXXXXXXX) |
NEW_RELIC_ACCOUNT_ID | 是 | - | NewRelic帐户ID |
NEW_RELIC_REGION | 没有 | US | API地区(US 或 EU) |
LOG_LEVEL | 没有 | info | 日志级别(debug / info / warn / error) |
API密钥在日志输出中自动进行编校。
演出
响应优化
所有工具响应都使用紧凑的JSON（没有空格）来减少令牌的使用。构建结构化响应对象的工具只包括基本字段——详细的NerdGraph元数据，如 __typename, permalink，以及 rawConfiguration 在返回原始API数据时被剥离。
速率限制
服务器强制执行NewRelic的API限制：
- 25个并发请求 基于信号量的背压
- 指数退避 429个响应（基本1秒，最大30秒，有抖动）
- 自动重试 用于速率限制和网络错误（3次尝试）
工具
数据访问——5个工具
| 工具 | 说明 |
|---|---|
execute_nrql_query | 执行具有完整结果解析的任意NRQL查询 |
list_recent_logs | 按时间范围和实体筛选列出最近的日志 |
analyze_entity_logs | 使用模式检测分析特定实体的日志 |
query_logs | 按字段/值搜索日志，可配置限制 |
natural_language_to_nrql_query | 从自然语言描述中获取NRQL查询建议 |
实体管理----5个工具
| 工具 | 说明 |
|---|---|
get_entity | 按GUID获取实体详细信息，包括摘要指标 |
list_related_entities | 查找与给定实体相关的实体 |
search_entity_with_tag | 按标签键/值对搜索实体 |
list_entity_types | 列出所有可用的实体类型和域 |
list_available_new_relic_accounts | 列出可访问的NewRelic帐户 |
警报和事件——8个工具
| 工具 | 说明 |
|---|---|
list_alert_policies | 列出带有条件计数的警报策略 |
list_alert_conditions | 列出策略的NRQL警报条件 |
list_recent_issues | 列出最近检测到的AI问题（实验性） |
search_incident | 按时间范围和实体搜索事件 |
analyze_deployment_impact | 分析部署对错误率和吞吐量的影响 |
generate_alert_insights_report | 生成全面的警报分析报告 |
get_entity_error_groups | 获取具有发生次数的实体的错误组 |
list_change_events | 列出部署和更改跟踪事件 |
仪表板和合成工具——3个工具
| 工具 | 说明 |
|---|---|
get_dashboard | 获取仪表板详细信息，包括小部件和NRQL查询 |
list_dashboards | 列出所有带分页的仪表板 |
list_synthetic_monitors | 列出带有状态和位置的合成监视器 |
性能分析——3个工具
| 工具 | 说明 |
|---|---|
analyze_golden_metrics | 分析实体黄金指标（吞吐量、错误、延迟） |
analyze_transactions | 分析最慢细分的事务性能 |
convert_time_period_to_epoch_ms | 将人类可读的时间段转换为纪元毫秒 |
实用工具——1个工具
| 工具 | 说明 |
|---|---|
convert_time_period_to_epoch_ms | 将“最近6小时”等时间描述转换为纪元时间戳 |
示例用法
查询错误率
execute_nrql_query with:
query: "SELECT percentage(count(*), WHERE error IS true) FROM Transaction SINCE 1 hour ago"查找慢速交易
analyze_transactions with:
entityGuid: "YOUR_APM_ENTITY_GUID"
sinceMinutesAgo: 60在日志中搜索错误
query_logs with:
field: "level"
value: "ERROR"
limit: 100获取编写NRQL的帮助
natural_language_to_nrql_query with:
description: "Show me error rates by service over the last 6 hours"发展
pnpm install # install dependencies
pnpm build # compile TypeScript
pnpm test # run tests
pnpm dev # run with tsx (no build needed)
pnpm watch # recompile on change
pnpm lint # lint with Biome
pnpm format # format with Biome项目结构
src/
index.ts # Entry point (stdio transport)
server.ts # MCP server creation and tool registration
config.ts # Environment variable parsing and validation
services/
nerdgraph-client.ts # Core GraphQL client with rate limiting and retry
nrql-service.ts # NRQL query execution
log-service.ts # Log querying and analysis
entity-service.ts # Entity retrieval and relationships
alert-service.ts # Alert policies, conditions, and incidents
dashboard-service.ts # Dashboard retrieval and listing
synthetic-service.ts # Synthetic monitor management
performance-service.ts # Transaction and golden metrics analysis
tools/
nrql-tools.ts # NRQL query tools
entity-tools.ts # Entity management tools
alert-tools.ts # Alert and incident tools
incident-tools.ts # Incident search and analysis tools
dashboard-tools.ts # Dashboard tools
log-tools.ts # Log query tools
performance-tools.ts # Performance analysis tools
synthetic-tools.ts # Synthetic monitor tools
account-tools.ts # Account listing tools
utility-tools.ts # Time conversion utilities
types/
newrelic.ts # NewRelic API type definitions
utils/
errors.ts # Custom error types (AuthenticationError, RateLimitError, etc.)
logger.ts # Structured stderr logging with API key redaction
response.ts # Response optimization (field stripping, compact JSON)
retry.ts # Exponential backoff retry with jitterDocker开发
docker compose build # build image
docker compose run --rm newrelic-mcp # run server
docker compose --profile dev up newrelic-mcp-dev # dev mode with hot reload故障排除
“缺少必需的环境变量”
确保 NEW_RELIC_API_KEY 和 NEW_RELIC_ACCOUNT_ID 被设置并传递给Docker。
“身份验证失败”
验证您的API密钥是否具有适当的权限。建议使用用户API密钥（NRAK-…）。
“超出费率限制”
服务器会自动重试回退。如果持续存在，请减少查询频率。
ai问题端点失败
这些使用实验性的NerdGraph标头。服务器会自动处理此问题 list_recent_issues 和 search_incident.
许可证
麻省理工学院