Grafana용 [모델 컨텍스트 프로토콜][mcp] (MCP) 서버입니다.

이 기능은 Grafana 인스턴스와 주변 생태계에 접근할 수 있게 해줍니다.

퀵 스타트

uv가 필요합니다. MCP 클라이언트 구성에 다음 것들을 추가하세요(예: Claude Desktop, 커서):

Grafana Cloud의 경우, 인스턴스 URL로 GRAFANA_URL를 교체하세요(예: https://myinstance.grafana.net). Docker, 바이너리, 헬름 등 더 많은 설치 옵션은 사용법을 참조하세요.

요구 사항

• Grafana 버전 9.0 이상이 완전한 기능을 위해 필요합니다. 일부 기능, 특히 데이터소스 관련 연산은 API 엔드포인트가 없어 이전 버전에서 제대로 작동하지 않을 수 있습니다.

특징

다음 _The 기능들이 현재 MCP 서버에서 이용 가능합니다. 이 목록은 정보 제공 목적으로만 제공되며 로드맵이나 향후 features._에 대한 약속을 나타내지 않습니다

대시보드

• 대시보드 검색: 제목, 폴더 UID, 태그, 별표 상태로 대시보드 찾기
• UID로 대시보드 가져오기: 고유 식별자를 사용해 전체 대시보드 세부 정보를 가져옵니다. 현재 대시보드 대신 저장된 스냅샷을 불러오기 위해 선택적 version를 통과하세요. _Warning: 대형 대시보드는 상당한 컨텍스트 윈도우 space._을 소모할 수 있습니다

Grafana MCP server

A [Model Context Protocol][mcp] (MCP) server for Grafana.

This provides access to your Grafana instance and the surrounding ecosystem.

Quick Start

Requires uv. Add the following to your MCP client configuration (e.g. Claude Desktop, Cursor):

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": ["mcp-grafana"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": ""
      }
    }
  }
}

For Grafana Cloud, replace GRAFANA_URL with your instance URL (e.g. https://myinstance.grafana.net). See Usage for more installation options including Docker, binary, and Helm.

Requirements

• Grafana version 9.0 or later is required for full functionality. Some features, particularly datasource-related operations, may not work correctly with earlier versions due to missing API endpoints.

Features

The following features are currently available in MCP server. This list is for informational purposes only and does not represent a roadmap or commitment to future features.

Dashboards

• Search for dashboards: Find dashboards by title, folder UID, tag, or starred status
• Get dashboard by UID: Retrieve full dashboard details using its unique identifier. Pass optional version to load a saved snapshot instead of the current dashboard. Warning: Large dashboards can consume significant context window space.
• List dashboard versions: List saved versions of a dashboard as compact metadata (version number, author, timestamp, save message)
• Get dashboard summary: Get a compact overview of a dashboard including title, panel count, panel types, variables, and metadata without the full JSON to minimize context window usage
• Get dashboard property: Extract specific parts of a dashboard using JSONPath expressions (e.g., $.title, $.panels[*].title) to fetch only needed data and reduce context window consumption