mcp-grafana

Grafana MCP 서버는 Claude Desktop이나 Cursor 같은 MCP 클라이언트를 Grafana 인스턴스 및 주변 생태계에 연결하는 Model Context Protocol(MCP) 서버입니다. 일부 데이터소스 작업이 최신 API 엔드포인트에 의존하므로 전체 기능을 사용하려면 Grafana 9.0 이상이 필요합니다. 설정은 MCP 클라이언트 구성에 항목을 추가하는 방식으로 이루어지며, 일반적으로 uvx를 통해 GRAFANA_URL과 서비스 계정 토큰을 환경 변수로 설정하여 서버를 실행합니다. Docker, 바이너리, Helm 설치 옵션도 문서화되어 있습니다. 기능은 도구 카테고리로 그룹화되며, 도구 목록을 구성할 수 있어 사용하지 않는 기능을 비활성화하여 컨텍스트 창 공간을 절약할 수 있습니다. --disable-oncall이나 --disable-navigation 같은 플래그로 카테고리를 끌 수 있으며, 여러 카테고리는 기본적으로 비활성화되어 있어 --enabled-tools를 통해 명시적으로 활성화해야 합니다. 대시보드 도구는 제목, 폴더 UID, 태그 또는 즐겨찾기 상태로 검색, UID 또는 저장된 버전으로 대시보드 가져오기, 버전 나열, 간결한 요약 가져오기, JSONPath로 일부 추출, 대시보드 생성·업데이트·패치, 데이터소스 정보와 함께 패널 쿼리 읽기를 지원합니다. README는 전체 대시보드 JSON이 상당한 컨텍스트 창 공간을 소비할 수 있으므로 요약이나 JSONPath 도구를 대신 사용할 것을 권장합니다. 데이터소스 및 쿼리 지원에는 데이터소스 나열 및 검사(Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena), PromQL 즉시 및 범위 쿼리와 메트릭 메타데이터 및 히스토그램 백분위수, LogQL 로그 및 메트릭 쿼리와 레이블·패턴 검색, InfluxQL 또는 Flux를 통한 InfluxDB, ClickHouse·Snowflake·Athena·MySQL·PostgreSQL·MSSQL용 통합 SQL 도구(매크로 치환 및 제한 적용 포함), CloudWatch 네임스페이스·메트릭·차원, Graphite 렌더 쿼리 및 메트릭 검색, Elasticsearch/OpenSearch 및 Quickwit 검색, 예제 쿼리 조회가 포함됩니다. SQL 쿼리는 Grafana 데이터소스 플러그인을 통해 실행되므로 자격 증명은 MCP 서버가 아닌 데이터소스 구성에서 처리됩니다. 운영 영역에는 알림(규칙 나열·생성·업데이트·삭제, 알림 정책, 연락처, 시간 간격), Grafana Incident(검색·생성·업데이트·사용자 정의 필드), Sift 조사(나열·상세·분석·오류 패턴 및 느린 요청 탐지), Grafana OnCall(스케줄·교대·현재 온콜 사용자·팀·사용자·알림 그룹), 주석(쿼리·생성·업데이트·패치·삭제·태그), 스냅샷(나열·가져오기·생성·삭제), Grafana Image Renderer를 통한 패널 또는 대시보드 PNG 렌더링, 프로비저닝 저장소 나열 및 드라이런 검증, 대시보드·패널·Explore용 딥링크 생성, 다중 조직 요청을 위한 사용자 신원 조회가 포함됩니다. Grafana Cloud 전용 Agent Observability 도구는 LLM 대화 나열 및 검색, 평가 점수가 포함된 대화·생성 상세, 버전 이력과 토큰 추정치가 있는 에이전트 카탈로그, 평가자와 템플릿, 평가 규칙과 가드, 저장된 대화와 컬렉션, 테스트 스위트, 오프라인 실험을 다룹니다. 이 중 일부는 특정 권한이 필요한 쓰기 작업을 포함합니다. Grafana Assistant 도구는 자연어 프롬프트를 어시스턴트에 보내고 반환된 컨텍스트 ID를 통해 대화를 계속하는 것을 지원하며, 쓰기 도구이므로 --disable-write가 설정되면 건너뜁니다. 접근 제어는 RBAC 기반입니다. 각 도구에는 특정 권한과 범위가 필요하며, README는 필요한 권한을 부여한 서비스 계정을 만들 것을 권장하고, 내장 Editor 역할이 더 단순하지만 덜 세분화된 대안이라고 언급합니다. Incident 및 Sift 도구는 세분화된 권한 대신 기본 Viewer/Editor 역할을 사용합니다. README에는 도구 이름을 카테고리, 필요한 RBAC 권한 및 필요한 범위에 매핑하는 도구 표가 포함되어 있습니다.