키바나 MCP 서버

API 사양
이 프로젝트는 공식 Elastic Kibana API 문서를 기반으로 하며, Elastic Stack 8.x(ES8)의 OpenAPI YAML 사양을 사용하여 모든 Kibana API 엔드포인트를 동적으로 검색하고 관리합니다. 최신 정보는 Kibana API 문서를 참조하세요.

자연어 또는 프로그래밍 방식 요청을 통해 모든 MCP 호환 클라이언트(예: Claude Desktop)가 Kibana 인스턴스에 액세스할 수 있도록 하는 Kibana MCP 서버 구현입니다.

이 프로젝트는 커뮤니티에서 유지 관리되며 Elastic이나 MCP의 공식 제품이 아닙니다.

특징

로컬 또는 원격 Kibana 인스턴스에 연결
보안 인증(사용자 이름/비밀번호)
SSL/TLS 및 사용자 정의 CA 인증서 지원
Kibana API 엔드포인트를 도구와 리소스로 모두 노출합니다.
MCP 클라이언트에서 Kibana API를 검색, 보기 및 실행합니다.
유형 안전, 확장성 및 통합 용이

디렉토리 구조

지엑스피1

자원

리소스 URI	설명
`kibana-api://paths`	사용 가능한 모든 Kibana API 엔드포인트를 반환합니다( `search` 매개변수로 필터링 가능)
`kibana-api://path/{method}/{encoded_path}`	특정 API 엔드포인트에 대한 세부 정보를 반환합니다.

예:

kibana-api://paths?search=saved_objects
kibana-api://path/GET//api/status

도구

도구 이름	설명	입력 매개변수
`get_status`	Kibana 서버의 현재 상태를 가져옵니다.	없음
`execute_api`	사용자 정의 Kibana API 요청 실행	`method` (GET/POST/PUT/DELETE), `path` (문자열), `body` (선택 사항), `params` (선택 사항)
`search_kibana_api_paths`	키워드로 Kibana API 엔드포인트 검색	`search` (문자열)
`list_all_kibana_api_paths`	모든 Kibana API 엔드포인트 나열	없음
`get_kibana_api_detail`	특정 Kibana API 엔드포인트에 대한 세부 정보 가져오기	`method` (문자열), `path` (문자열)

프롬프트

프롬프트 이름	설명
`kibana-tool-expert`	도구 전문가 모드(Claude Desktop에서 강력 추천)는 도구를 통해 Kibana API에 대한 지능적인 분석, 검색, 실행 및 설명을 지원합니다. 대부분의 사용자에게 권장됩니다.
`kibana-resource-helper`	리소스 도우미 모드는 리소스 URI를 통해 Kibana API 정보에 액세스하고 사용하는 방법을 안내합니다. 리소스 액세스만 지원하거나 원시 API 메타데이터가 필요한 클라이언트에 적합합니다.

구성

환경 변수를 통해 서버를 구성하세요.

변수 이름	설명	필수의
`KIBANA_URL`	Kibana 서버 주소(예 : http://localhost:5601 )	예
`KIBANA_USERNAME`	키바나 사용자 이름	예
`KIBANA_PASSWORD`	키바나 비밀번호	예
`KIBANA_CA_CERT`	CA 인증서 경로(선택 사항, SSL 확인용)	아니요
`KIBANA_TIMEOUT`	요청 시간 초과(ms) (기본값 30000)	아니요
`KIBANA_MAX_RETRIES`	최대 요청 재시도 횟수(기본값 3)	아니요
`NODE_TLS_REJECT_UNAUTHORIZED`	SSL 인증서 유효성 검사를 비활성화하려면 `0` 으로 설정하세요(신중하게 사용하세요)	아니요

용법

서버 시작

KIBANA_URL=http://your-kibana-server:5601 \
KIBANA_USERNAME=your-username \
KIBANA_PASSWORD=your-password \
NODE_TLS_REJECT_UNAUTHORIZED=0 \
npm start

MCP 클라이언트 구성 예

Claude Desktop 구성 파일에 다음을 추가합니다(MacOS 경로: ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "kibana-mcp-server": {
      "command": "node",
      "args": ["/path/to/mcp-server-kibana/dist/index.js"],
      "env": {
        "KIBANA_URL": "http://your-kibana-server:5601",
        "KIBANA_USERNAME": "your-username",
        "KIBANA_PASSWORD": "your-password",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

예제 쿼리

"내 Kibana 서버 상태는 어떻습니까?"
"사용 가능한 Kibana API 엔드포인트를 모두 나열하세요."
"POST /api/saved_objects/_find 엔드포인트에 대한 세부 정보를 표시합니다."
"/api/status에 대한 사용자 정의 API 요청을 실행합니다."
"Kibana의 모든 대시보드 목록을 가져옵니다."
"엔드포인트 이벤트와 관련된 API 엔드포인트를 쿼리합니다."
"모든 사례 관련 API 엔드포인트를 나열하세요."
"Kibana에서 새로운 사례를 만듭니다."
"Kibana에서 새로운 대시보드를 만드세요."

Claude Desktop의 두 가지 프롬프트 모드

이 서버를 Claude Desktop과 함께 사용하면 두 가지 다른 즉각적인 상호작용 모드가 지원됩니다.

1. 도구 기반 프롬프트 모드

작동 방식: Claude Desktop은 서버 도구(예: get_status , execute_api , search_kibana_api_paths 등)를 직접 호출하여 질문에 답하거나 작업을 수행할 수 있습니다.
최적의 사용자: 대화형 가이드 경험을 원하는 사용자. 이 서버는 Kibana API를 자동으로 검색, 실행 및 설명합니다.
예: "저장된 객체와 관련된 모든 Kibana API 엔드포인트를 표시합니다."
테스트 팁: 통합 테스트를 위해 Claude Desktop에서 kibana-tool-expert 프롬프트를 선택한 다음 사용을 시작하세요.

2. 리소스 기반 프롬프트 모드

작동 방식: Claude Desktop은 리소스 URI(예: kibana-api://paths 또는 kibana-api://path/GET//api/status )를 통해 서버와 상호 작용하고, 서버는 Claude가 구문 분석할 수 있도록 구조화된 데이터를 반환합니다.
가장 적합한 대상: 고급 사용자, 리소스 액세스만 지원하는 MCP 클라이언트 또는 원시 API 메타데이터가 필요한 프로그래밍 시나리오.
예: "리소스 kibana-api://paths?search=dashboard 가져오기"

참고: resources ( kibana-api://paths 및 kibana-api://path/{method}/{encoded_path} )의 두 엔드포인트에는 해당 기본 도구( list_all_kibana_api_paths , get_kibana_api_detail )가 있습니다. 이러한 설계는 여러 리소스를 지능적으로 선택할 수 없는 MCP 클라이언트와의 호환성을 보장하여 Claude Desktop과 같은 도구가 Kibana와 더 쉽게 상호 작용할 수 있도록 합니다.

팁: 대부분 사용자는 보다 자연스럽고 강력한 경험을 위해 도구 모드를 사용하는 것이 좋습니다. 반면 리소스 모드는 고급 및 호환성 사용 사례에 대해 최대한의 유연성을 제공합니다.

개발

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

개발 모드에서 자동 다시 빌드:

npm run watch

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 불편할 수 있습니다. MCP Inspector를 사용하는 것이 좋습니다.

npm run inspector

Inspector를 시작하면 브라우저에서 접근 가능한 디버깅 도구 URL이 제공됩니다.

지역 사회

이 프로젝트는 커뮤니티에서 관리됩니다. 기여와 피드백을 환영합니다! 모든 소통에서 존중과 포용성을 지켜주시고, Elastic 커뮤니티 행동 강령을 준수해 주세요.

특허

이 프로젝트는 Apache 라이선스 2.0에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

문제 해결

MCP 구성이 올바른지 확인하세요
Kibana 주소에 액세스할 수 있는지 확인하세요.
인증 자격 증명에 충분한 권한이 있는지 확인하세요.
사용자 지정 CA를 사용하는 경우 인증서 경로가 올바르고 읽을 수 있는지 확인하세요.
NODE_TLS_REJECT_UNAUTHORIZED=0 사용하는 경우 보안 위험에 유의하세요.
터미널에서 오류 메시지 출력을 확인하세요

Kibana MCP Server