NewRelic MCP Server

newrelic mcp服务器

NewRelic的综合MCP服务器，有25个工具用于查询、监控和分析您的可观察性数据——NRQL、实体、警报、仪表板、日志等。

快速开始

使用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密钥 （建议使用许可证密钥）：

API密钥在日志输出中自动进行编校。

演出

响应优化

所有工具响应都使用紧凑的JSON（没有空格）来减少令牌的使用。构建结构化响应对象的工具只包括基本字段——详细的NerdGraph元数据，如 __typename, permalink，以及 rawConfiguration 在返回原始API数据时被剥离。

速率限制

服务器强制执行NewRelic的API限制：

• 25个并发请求 基于信号量的背压
• 指数退避 429个响应（基本1秒，最大30秒，有抖动）
• 自动重试 用于速率限制和网络错误（3次尝试）

工具

数据访问——5个工具

实体管理----5个工具

警报和事件——8个工具

仪表板和合成工具——3个工具

性能分析——3个工具

实用工具——1个工具

示例用法

查询错误率

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 jitter

Docker开发

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.

许可证

麻省理工学院