New Relic MCP 서버
NRQL 쿼리를 사용하여 New Relic 로그를 쿼리하는 간단한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Claude와 같은 대용량 언어 모델(LLM)이 New Relic 데이터와 상호 작용할 수 있습니다.
특징
- NRQL을 사용하여 New Relic 로그 및 메트릭 쿼리
- 자세한 오류 로깅
- Claude Desktop과의 간편한 통합
- 사람이 읽을 수 있는 출력 형식
- 구성 가능한 New Relic 계정 ID
설치 지침
필수 조건
- Python 3.10 이상
- New Relic 계정 및 API 키
- 클로드 데스크톱 애플리케이션
설치 단계
uv 패키지 관리자를 설치하세요:
지엑스피1
- 프로젝트 생성 및 설정:
# 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 - 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 쿼리 예시
- 기본 거래 쿼리:
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
클로드 프롬프트 예시
클로드에게 다음과 같은 질문을 할 수 있습니다.
- "지난 1시간 동안의 모든 거래를 보여주세요"
- "우리의 애플리케이션에 오류가 있나요?"
- "가장 느린 종료 지점은 어디인가요?"
디버깅
로그 보기
# 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
일반적인 문제
- 인증 오류:
- 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 쿼리 도구
- 구성 가능한 New Relic 계정 ID
- 포괄적인 오류 처리
- 자세한 로깅
- 응답 형식
변경 사항 테스트
- 필요에 따라 코드를 수정하세요
- MCP Inspector로 테스트
- 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요.
문제 해결 가이드
- 서버가 시작되지 않음:
- Python 버전 확인
- 모든 종속성이 설치되었는지 확인하세요
- 가상 환경이 활성화되었는지 확인하세요
- 쿼리가 작동하지 않습니다:
- 자세한 오류 메시지는 로그에서 확인하세요.
- NRQL 구문 확인
- 쿼리된 시간 범위 내에 데이터가 있는지 확인하세요.
- 클로드가 연결되지 않음:
- 구성 파일 구문 확인
- 경로가 절대적인지 확인하세요
- Claude Desktop을 다시 시작하세요
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 풀 리퀘스트 제출
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.
지원하다
문제가 발생하는 경우:
- 로그를 확인하세요
- 일반적인 문제 섹션을 검토하세요
- MCP Inspector로 테스트
- GitHub에 문제를 제출하세요