Elastic Apm Mcp Server

БесплатноНе проверен

MCP server for monitoring Elastic APM via Kibana API

автор: snvlqkq

GitHub Embed

Описание

MCP server for monitoring Elastic APM via Kibana API

README

Kibana API를 통해 APM 데이터(서비스 목록, 트랜잭션 성능, 에러, 런타임 메트릭)를 조회하는 MCP 서버입니다.

요구사항

Node.js 18 이상
Kibana 8.x (Kibana 내부 엔드포인트를 사용하므로 버전에 따라 동작이 달라질 수 있습니다)

설정

Claude Desktop 또는 Claude Code 설정에 다음을 추가합니다. 별도 설치 없이 npx로 바로 실행됩니다.

Claude Code

CLI로 바로 추가 (API Key 인증, 권장):

claude mcp add elastic-apm \
  -e KIBANA_URL=http://your-kibana-host:5601 \
  -e KIBANA_API_KEY=your-base64-encoded-api-key \
  -- npx -y elastic-apm-mcp-server

ID/PW 인증을 쓰려면:

claude mcp add elastic-apm \
  -e KIBANA_URL=http://your-kibana-host:5601 \
  -e KIBANA_USERNAME=your-username \
  -e KIBANA_PASSWORD=your-password \
  -- npx -y elastic-apm-mcp-server

또는 ~/.claude/settings.json에 직접 추가:

{
  "mcpServers": {
    "elastic-apm": {
      "command": "npx",
      "args": ["-y", "elastic-apm-mcp-server"],
      "env": {
        "KIBANA_URL": "http://your-kibana-host:5601",
        "KIBANA_API_KEY": "your-base64-encoded-api-key"
      }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 에 동일한 형식으로 추가합니다.

환경변수

환경변수	필수	설명
`KIBANA_URL`	O	Kibana 접속 URL
`KIBANA_API_KEY`	△	Kibana/Elasticsearch API Key (base64 인코딩된 키 값). 설정 시 이 방식이 우선 사용됨
`KIBANA_USERNAME`	△	Kibana 사용자 이름 (API Key 미사용 시 필요)
`KIBANA_PASSWORD`	△	Kibana 비밀번호 (API Key 미사용 시 필요)

인증은 두 방식 중 하나를 선택합니다. KIBANA_API_KEY 를 설정하거나, KIBANA_USERNAME + KIBANA_PASSWORD 를 설정하세요. 둘 다 있으면 API Key가 우선합니다.

제공 도구

도구	설명
`list_services`	APM에 등록된 서비스 목록 조회
`get_service_overview`	특정 서비스의 트랜잭션 성능과 에러 요약 조회
`get_transactions`	특정 서비스의 트랜잭션 성능 통계 조회
`get_errors`	특정 서비스의 에러 그룹 조회
`get_service_metrics`	특정 서비스의 CPU/메모리 등 런타임 메트릭 조회 (agent 종류별 상이)
`get_jvm_memory_pools`	JVM heap을 pool(Eden/Survivor/Old Gen)별로 시계열 조회 (Java 전용). pool별 used/committed/max + floor/avg/peak 제공
`get_transaction_samples`	특정 트랜잭션의 샘플 트레이스(traceId) 조회, 느린 트랜잭션 필터링 가능
`get_trace`	trace ID로 트랜잭션 전체 span(워터폴)을 조회하여 병목 구간 파악

사용 예시

MCP 설정 후 Claude에게 자연어로 요청하면 됩니다.

"APM 서비스 목록 보여줘"
"auth-service의 최근 1시간 에러 조회해줘"
"payment-service 트랜잭션 성능 확인해줘"
"payment-service에서 제일 느린 요청 하나 까서 어디서 시간 쓰는지 보여줘"
"payment-service의 업무시간(09~18시) Old Gen 사용량이 자기 max 대비 몇 %인지 보여줘"

License

ISC

from github.com/kimjunyoung90/elastic-apm-mcp-server

Установить Elastic Apm Mcp Server в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install elastic-apm-mcp-server

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add elastic-apm-mcp-server -- npx -y elastic-apm-mcp-server

FAQ