New Relic MCP 서버

AI 어시스턴트를 New Relic에 안전하게 연결하세요.

프로덕션 지향적이며 자체 호스팅 가능한 Model Context Protocol (MCP) 서버로, Claude, Cursor, Codex 및 기타 MCP 클라이언트에게 NRQL, 로그, 메트릭, 트레이스, 오류, 엔티티, 알림, 인시던트, 대시보드, 신세틱스, 워크로드, 서비스 수준 및 선택된 관리 API에 대한 타입이 지정된 읽기 전용 기본 액세스를 제공합니다. 모든 것은 New Relic의 NerdGraph를 통해 이루어집니다.

이 서버는 의도적으로 임의의 GraphQL을 노출하지 않으며, 클라이언트 자격 증명을 New Relic에 전달하지 않으며, New Relic 키를 도구 인수로 받지 않습니다. 변형(mutation)은 해당 기능 게이트가 명시적으로 활성화되지 않는 한 존재하지 않으며, 모든 쓰기 작업은 dry-run, 확인 구문, 쓰기 후 읽기 확인 워크플로를 사용합니다.

주요 특징

• 🔒 기본적으로 안전 — 기본적으로 읽기 전용입니다. 쓰기는 옵트인(opt-in)이며 게이트가 있고 dry-run → 확인 구문 → 쓰기 후 읽기 확인 흐름을 실행합니다.

• 🧱 제한된 API 표면 — 고정되고 문서화된 NerdGraph 작업 집합입니다. 임의의 GraphQL이 없으며 도구 인수로 자격 증명이 전달되지 않습니다.

• 🔌 모든 MCP 클라이언트와 호환 — Claude Code, Claude Desktop, Cursor, Codex 등과 stdio 또는 상태 비저장 Streamable HTTP를 통해 작동합니다.

• 📈 내장 사용량 텔레메트리 — 도구별 호출 수, 기간 및 결과를 제공하는 Prometheus /metrics 엔드포인트와 업스트림 NerdGraph, 큐 깊이, 재시도, 속도 제한 및 캐시 메트릭이 포함됩니다.

• 🏢 엔터프라이즈 준비 — bearer/OIDC 인증, 호스트/출처 허용 목록, 계정 허용 목록, 비밀 및 PII 수정, Docker 및 Helm.

• 🧰 광범위한 범위 — NRQL, 엔티티, 알림, 대시보드, 신세틱스, 워크로드, 서비스 수준, 로그 및 메트릭을 위한 독립적으로 선택 가능한 도구 세트.

• 📚 문서화 및 테스트됨 — 아키텍처 문서, ADR, 그리고 CI에서 모든 변경 사항을 검증하는 단위/통합/계약/보안/부하 테스트 스위트.

Related MCP server: New Relic MCP Server

무엇을 요청할 수 있나요?

연결되면 MCP 클라이언트에게 일반 언어로 요청하세요. 클라이언트가 적절한 읽기 전용 도구를 선택하고 호출합니다:

• "지난 1시간 동안 체크아웃 서비스에서 가장 느린 트랜잭션은 무엇인가요?"

• "결제 팀의 열린 인시던트와 그 가능성 있는 원인을 요약해 주세요."

• "이번 주에 목표를 놓칠 위험이 있는 서비스 수준은 어느 것인가요?"

• "내 알림 정책을 검토하고 커버리지 격차를 지적해 주세요."

• "밤사이 로그인 신세틱 모니터가 실패한 이유는 무엇인가요?"

전체 기능 목록은 도구 카탈로그를 참조하세요.

왜 이 MCP인가요?

New Relic은 공식적으로 New Relic 호스팅 MCP 서버(New Relic AI MCP, 현재 프리뷰)를 제공합니다. 이 프로젝트는 보완적인 자체 호스팅 및 오픈 소스 대안입니다. 다음 상황에서 선택하세요:

• 자체 호스팅 및 제어 — 자체 네트워크 내에서 자체 자격 증명으로 MCP 브리지를 실행합니다. 외부로 나가는 것은 NerdGraph 호출뿐입니다. (New Relic의 프리뷰는 FedRAMP 규제 계정에 제공되지 않습니다.)

• 기본 읽기 전용, 게이트된 쓰기 — 모든 변형은 옵트인이며 dry-run → 확인 구문 → 읽기 확인 흐름을 실행합니다.

• 고정되고 감사 가능한 작업 표면 — 문서화된 NerdGraph 작업 집합이며, 임의의 GraphQL이 없고 New Relic 키가 도구 인수로 전달되지 않습니다.

• 자체 제어 — bearer/OIDC 인증, 호스트/출처 및 계정 허용 목록, 비밀 수정, 독립적으로 선택 가능한 도구 세트.

• 일류 텔레메트리 — 기존 관찰 가능성 스택으로 스크랩할 수 있는 도구 사용량 및 업스트림 호출에 대한 Prometheus 메트릭.

• Apache-2.0 및 포크 가능 — 배포하는 항목을 정확히 검사, 고정 및 확장할 수 있습니다.

운영이 필요 없는 New Relic 관리형 경험과 New Relic AI 통합을 원한다면 공식 서버가 더 적합할 수 있습니다. 이 프로젝트는 편의성 대신 자체 호스팅, 제어 및 감사 가능성을 제공합니다.

프로젝트 상태: 1.0.0. 지원되는 작업 매트릭스를 검토하고 쓰기를 활성화하기 전에 비프로덕션 New Relic 계정에서 권한을 확인하세요. MCP 레지스트리, npm, 컨테이너 및 MCPB 메타데이터는 준비되었지만, 이 저장소는 유지 관리자 자격 증명 없이 아티팩트를 게시하지 않습니다.

요구 사항

• Node.js 22.7.5 이상; 프로덕션에는 Node 24 LTS를 권장합니다.

• 활성화된 도구 세트에 필요한 권한만 있는 New Relic 사용자 키.

• US 또는 EU 엔드포인트를 사용하는 New Relic 계정, 또는 검증된 JP 호환성 엔드포인트 배포 (구성 참조).

• stdio 또는 Streamable HTTP를 지원하는 MCP 클라이언트.

New Relic은 해당 사용자가 소유한 모든 키에 대해 사용자당 25개의 동시 NerdGraph 요청 제한을 적용합니다. 이 서버는 기본적으로 총 20개 요청과 5개의 복잡한 NRQL 쿼리로 설정됩니다. 복제본을 추가하기 전에 성능 및 확장을 참조하세요. 일반 HTTP 호출은 세션이 없습니다. 여러 복제본에 걸친 프롬프트 SDK 취소는 추가로 결정론적 로드 밸런서 선호도가 필요합니다.

빠른 시작: stdio

패키지를 전역으로 설치합니다:

npm install --global @meet-bhalodiya/newrelic-mcp
export NEW_RELIC_API_KEY='NRAK-...'
export NEW_RELIC_REGION='US'
newrelic-mcp doctor --json
newrelic-mcp

또는 MCP 클라이언트가 npx를 통해 고정된 패키지를 호출하도록 합니다:

NEW_RELIC_API_KEY='NRAK-...' \
  npx -y @meet-bhalodiya/newrelic-mcp@1.0.0 doctor --json

Stdio는 MCP 프레임에 stdout을 예약합니다. 런타임 진단 및 로그는 stderr로 전송됩니다.

빠른 시작: 인증된 HTTP

서비스 계정만 읽을 수 있는 두 개의 파일을 생성합니다:

install -m 0700 -d ./secrets
printf '%s' "$NEW_RELIC_API_KEY" > ./secrets/new_relic_api_key
openssl rand -hex 32 > ./secrets/mcp_bearer_token
chmod 0400 ./secrets/*

루프백 전용 컨테이너를 시작합니다:

docker compose up --build

MCP 엔드포인트는 http://127.0.0.1:3000/mcp입니다. 상태 확인은 /healthz 및 /readyz에 있습니다. Docker Compose는 의도적으로 정적 bearer 인증을 활성화합니다. ./secrets/mcp_bearer_token에서 토큰을 읽고 Authorization: Bearer <token>으로 보냅니다.

네이티브 프로세스의 경우:

export NEW_RELIC_API_KEY_FILE="$PWD/secrets/new_relic_api_key"
export MCP_AUTH_MODE=bearer
export MCP_BEARER_TOKEN_FILE="$PWD/secrets/mcp_bearer_token"
newrelic-mcp http --host 127.0.0.1 --port 3000

비루프백 HTTP는 bearer 또는 OIDC 인증, 명시적 호스트 허용 목록, 리버스 프록시에서 TLS, 브라우저 클라이언트를 위한 출처 허용 목록을 사용해야 합니다. 배포 및 보안을 참조하세요.

클라이언트 설정

이 짧은 예제는 읽기 전용 stdio 서버를 사용합니다. 전체 가이드는 원격 bearer 및 OAuth 설정과 클라이언트별 주의 사항을 포함합니다.

Claude Code

claude mcp add --transport stdio --scope user \
  --env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \
  --env NEW_RELIC_REGION=US \
  newrelic -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0

Claude Code 내에서 /mcp를 사용하여 연결을 확인합니다.

Claude Desktop

가장 안전한 로컬 설치를 위해 .mcpb 번들을 빌드하거나 다운로드하고 설정 → 확장 → 고급 설정 → 확장 설치를 사용하세요. Claude Desktop은 민감한 것으로 표시된 필드를 OS 보안 저장소에 저장합니다. 수동 로컬 stdio JSON 예제는 클라이언트 구성에 있습니다. 원격 서버는 claude_desktop_config.json이 아닌 설정 → 커넥터를 통해 추가해야 합니다.

Cursor

examples/cursor.mcp.json을 프로젝트의 .cursor/mcp.json 또는 전역적으로 ~/.cursor/mcp.json에 복사합니다. NEW_RELIC_API_KEY를 사용할 수 있는 환경에서 Cursor를 시작한 다음 MCP 설정에서 서버를 활성화합니다.

Codex

codex mcp add newrelic \
  --env NEW_RELIC_REGION=US \
  --env NEW_RELIC_API_KEY="$NEW_RELIC_API_KEY" \
  -- npx -y @meet-bhalodiya/newrelic-mcp@1.0.0
codex mcp list

Codex CLI, Codex IDE 확장 및 동일한 Codex 호스트의 ChatGPT 데스크톱 앱은 config.toml을 공유합니다. Streamable HTTP bearer 및 OAuth 모드는 Codex 예제를 참조하세요.

CLI

newrelic-mcp [stdio]
newrelic-mcp http [--host HOST] [--port PORT]
newrelic-mcp doctor [--json]
newrelic-mcp tools [--json]

• stdio (또는 하위 명령어 없음)는 로컬 전송을 시작합니다.

• http는 상태 비저장 Streamable HTTP를 /mcp에 제공하며 상태 엔드포인트도 포함합니다. 제한된 취소 레지스트리는 프로세스 로컬입니다.

• doctor는 구성, 자격 증명, 리전, 접근 가능한 계정 및 실제로 활성화된 모든 도구 세트에 대해 하나의 제한된 고정 쿼리 스키마 선택을 검증합니다. 변형을 실행하지 않으며 비밀을 출력하지 않습니다.

• tools는 활성화된 도구 세트와 안전 게이트를 New Relic에 접촉하지 않고 보고합니다.

안전 모델

게이트를 활성화하면 해당 도구가 등록되지만, New Relic 권한이나 HTTP 인증 범위를 우회하지는 않습니다. 쓰기는 여전히 기본적으로 dry-run입니다. dry-run에서 반환된 정확한 확인 구문을 동일한 인수로 적용하세요. 확인 구문은 정규화된 변경 사항과 사전 읽기 상태에 바인딩됩니다. 다른 상태 변경은 새로운 dry-run이 필요합니다.

이 프로젝트는 의도적으로 API 키 생성, 신세틱 보안 자격 증명 변형, 라이브 대시보드 비밀번호 및 재설정, 기록 내보내기 URL, Slack 대상 생성, 임의의 엔티티 삭제, 텔레메트리 수집 및 원시 GraphQL을 제외합니다.

도구 세트 및 MCP 기능

기본 읽기 표면은 독립적으로 선택 가능한 도구 세트로 분할됩니다:

• core

• nrql

• entities

• alerts

• dashboards

• synthetics

• workloads

• service-levels

• logs

• metrics

• admin (절대 암시적으로 활성화되지 않음)

정확한 런타임 카탈로그는 newrelic-mcp tools --json을 사용하고 설명은 tool-catalog.md를 참조하세요. 리소스에는 서버 기능, 계정 및 타입이 지정된 엔티티/구성 템플릿이 포함됩니다. 정적 프롬프트는 인시던트 분류, 서비스 상태, 알림 정책 검토, SLO 검토, 대시보드 설계 및 신세틱 실패 분석을 다룹니다. 프롬프트 및 리소스 지원이 MCP 클라이언트마다 다르기 때문에 도구가 권위 있는 범용 인터페이스로 남아 있습니다.

구성

구성은 시작 시 검증됩니다. 가장 중요한 설정은 다음과 같습니다:

NEW_RELIC_API_KEY=                  # xor NEW_RELIC_API_KEY_FILE
NEW_RELIC_REGION=US                 # US, EU, or JP
NEW_RELIC_DEFAULT_ACCOUNT_ID=
NEW_RELIC_ACCOUNT_ALLOWLIST=
NEW_RELIC_TOOLSETS=core,nrql,entities
MCP_AUTH_MODE=none                  # none, bearer, oidc

파일 기반 비밀은 서비스에 선호되며 환경 변수와 동일한 값을 가져야 합니다. 두 형식을 모두 설정하지 마십시오. 우선순위, 모든 설정, 검증 규칙 및 예제는 configuration.md를 참조하세요.

개발

npm ci
npm run build
npm run lint
npm run typecheck
npm test
npm run verify
npm pack --dry-run

작업 공간별 HTTP 포트로 로컬에서 실행합니다:

CONDUCTOR_PORT=3100 npm run dev:http

옵트인 라이브 테스트는 명시적 계정이 필요하며, 별도의 일회용 계정 쓰기 플래그가 설정되지 않은 경우 읽기 전용입니다. development.md 및 CONTRIBUTING.md를 참조하세요.

문서

• 아키텍처

• 구성 참조

• 도구 카탈로그

• New Relic 권한 및 에디션

• 클라이언트 구성

• 배포

• 성능

• 보안 및 위협 모델

• 문제 해결

• 공식 API 소스 매트릭스

• 릴리스 프로세스

• 종속성 정책

• 아키텍처 결정

기여하기

기여를 환영합니다 — 버그 리포트, 공식 New Relic 문서에 기반한 기능, 문서, 테스트 모두 환영합니다. CONTRIBUTING.md와 good first issues부터 시작하세요. 모든 참여는 행동 강령을 따릅니다.

이 프로젝트가 귀하나 팀에 유용하다면, ⭐ 하나가 다른 사람들이 발견하는 데 도움이 됩니다.

지원 및 보안

도움이 필요하신가요? SUPPORT.md를 참조하세요. 재현 가능한 버그와 기능 요청은 GitHub Issues를 사용하시고, New Relic 키, 베어러 토큰, NRQL, 계정 데이터, 엔티티 세부 정보, 원시 응답 또는 사전 서명된 URL을 절대 포함하지 마세요.

취약점은 SECURITY.md에 따라 비공개로 보고해 주세요.

라이선스

Apache License 2.0. LICENSE를 참조하세요.