grafana/mcp-grafana

어떤 프로젝트인가요?

핵심 기능

• 01JSONPath 속성 추출 및 패치를 포함해 Grafana 대시보드를 검색, 조회, 수정합니다.
• 02MCP 도구를 통해 Prometheus, Loki, InfluxDB, Elasticsearch, CloudWatch 및 SQL 데이터 소스를 조회합니다.
• 03알림 규칙, 알림 정책, 연락처를 관리합니다.
• 04Grafana OnCall 일정과 알림 그룹을 조회하고 관리합니다.
• 05Grafana Image Renderer를 통해 대시보드 패널을 PNG 이미지로 렌더링합니다.
• 06명령줄 플래그로 도구 카테고리를 활성화하거나 비활성화합니다.

활용 사례

• Grafana에서 메트릭과 로그를 조회해 AI 어시스턴트가 프로덕션 인시던트를 조사하도록 합니다.
• 컨텍스트 사용량을 낮게 유지하면서 자연어 요청으로 대시보드를 만들거나 수정합니다.
• 채팅 인터페이스를 통해 알림 규칙과 온콜 일정을 점검합니다.
• 보고서나 채팅 알림에 사용할 대시보드 이미지를 생성합니다.

빠른 시작

1. 1

   uvx를 사용하려면 uv를 설치하세요

2. 2

   GRAFANA_URL과 서비스 계정 토큰을 사용해 MCP 클라이언트 설정에 Grafana MCP 서버를 추가하세요

3. 3

   uvx로 서버를 실행하세요

   uvx mcp-grafana

사용 전 알아둘 점

• !모든 기능을 사용하려면 Grafana 9.0 이상이 필요하며, 이전 버전에서는 일부 데이터 소스 기능이 작동하지 않을 수 있습니다.
• !패널 쿼리 실행, SQL, CloudWatch, InfluxDB 등의 많은 도구는 기본적으로 비활성화되어 있으며 --enabled-tools로 활성화해야 합니다.

토픽

자주 묻는 질문

mcp-grafana은(는) 무엇인가요?

AI 어시스턴트가 Grafana 대시보드, 데이터 소스, 알림, 인시던트 등에 접근할 수 있도록 하는 MCP 서버입니다. mcp-grafana는 Go로 작성된 Model Context Protocol 서버로, Claude Desktop 및 Cursor와 같은 MCP 호환 클라이언트를 Grafana 인스턴스에 연결합니다. Grafana URL과 서비스 계정 토큰을 설정하면 어시스턴트가 대시보드를 검색하고 읽거나 패널 쿼리를 실행하고, Prometheus, Loki, ClickHouse, Elasticsearch, CloudWatch 등의 연결된 데이터 소스를 조회할 수 있습니다.

mcp-grafana은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mcp-grafana은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mcp-grafana은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mcp-grafana의 마지막 커밋은 2026년 10월 22일입니다.

mcp-grafana은(는) 어디에 사용할 수 있나요?

Grafana에서 메트릭과 로그를 조회해 AI 어시스턴트가 프로덕션 인시던트를 조사하도록 합니다. 컨텍스트 사용량을 낮게 유지하면서 자연어 요청으로 대시보드를 만들거나 수정합니다. 채팅 인터페이스를 통해 알림 규칙과 온콜 일정을 점검합니다. 보고서나 채팅 알림에 사용할 대시보드 이미지를 생성합니다.

mcp-grafana는 어떻게 설치하나요?

uvx를 사용하려면 uv를 설치하세요 GRAFANA_URL과 서비스 계정 토큰을 사용해 MCP 클라이언트 설정에 Grafana MCP 서버를 추가하세요 uvx로 서버를 실행하세요: uvx mcp-grafana

mcp-grafana은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/grafana/mcp-grafana