elastic-apm-mcp-server

Kibana APM API를 통해 서비스 목록, 트랜잭션 성능, 에러를 조회하는 MCP 서버입니다.

요구사항

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

설정

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

Claude Code

CLI로 바로 추가:

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_USERNAME": "your-username",
        "KIBANA_PASSWORD": "your-password"
      }
    }
  }
}

Claude Desktop

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

환경변수

환경변수	필수	설명
KIBANA_URL	O	Kibana 접속 URL
KIBANA_USERNAME	O	Kibana 사용자 이름
KIBANA_PASSWORD	O	Kibana 비밀번호

제공 도구

도구	설명
list_services	APM에 등록된 서비스 목록 조회
get_service_overview	특정 서비스의 트랜잭션 성능과 에러 요약 조회
get_transactions	특정 서비스의 트랜잭션 성능 통계 조회
get_errors	특정 서비스의 에러 그룹 조회

사용 예시

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

• "APM 서비스 목록 보여줘"
• "auth-service의 최근 1시간 에러 조회해줘"
• "payment-service 트랜잭션 성능 확인해줘"

License

ISC