Skip to main content
Glama
At-grafana

At-grafana

by xwamt

AT Grafana

中文

AT Grafana는 AT 시리즈(at-terminal-series 및 at-jumpserver-series와 함께)에 속한 VS Code / Cursor 확장 프로그램입니다. Grafana 대시보드와 Unified Alerting을 IDE로 가져오며, 공유 @at-series/mcp-hub Protocol v1을 통해 에이전트에게 읽기 전용 Grafana 메타데이터와 데이터소스 쿼리(Prometheus, Loki 등)를 노출합니다.

현재 버전: 0.1.3 — MCP 카탈로그가 17개의 읽기 전용 도구(타입화된 Prom/Loki, 검색, 주석, 딥링크)에 맞춰 정렬됨. 자동화 테스트 스위트: 타입체크 + 559개 테스트. docs/releases/0.1.3.md 참조. 실시간 Grafana / 실제 MCP 클라이언트 스모크 체크는 docs/releases/0.1.0.md에 계속 나열되어 있습니다.

기능

  • 다중 인스턴스 구성 — 라벨, URL, Grafana Service Account Token(9.1+); 토큰은 VS Code SecretStorage에 저장되며 일반 텍스트 설정에 절대 노출되지 않음

  • TLS Trust-On-First-Use — 첫 연결 시 인증서 지문 확인 프롬프트 표시; 지문 변경 시 안전하게 차단(fail closed)

  • 대시보드 사이드바 — Grafana 폴더 트리, 제목 필터, 새로고침; 임베디드 Webview에서 대시보드 열기

  • 알림 사이드바 — 실시간 상태를 표시하는 Unified Alerting 규칙, 폴더별 그룹화, Firing 규칙 우선 정렬

  • 네이티브 임베디드 페이지 — 확장 프로그램 측에서 Authorization을 주입하는 로컬 127.0.0.1 리버스 프록시를 통한 완전한 인터랙티브 Grafana 대시보드 / 알림 상세 UI(토큰은 Webview에 절대 노출되지 않음)

  • 인스턴스별 에이전트 게이트 — "Allow background Agent access"(기본값: 꺼짐); 활성화된 인스턴스만 MCP 도구에 표시됨

  • 17개 MCP 도구(risk: read, AT Series MCP 설치 후 자동 승인):

    • 검색: grafana_list_instances

    • 관리: grafana_list_dashboards(선택적 query / tag / folderUid), grafana_get_dashboard(기본값 fields: "targets"; 전체 모델은 fields: "full" 필요), grafana_list_folders, grafana_list_alert_rules(선택적 states), grafana_get_alert_rule, grafana_get_alert_history, grafana_list_annotations, grafana_generate_deeplink(openInIde 기본값 false)

    • 모니터링: grafana_list_datasources, grafana_query_prometheus, grafana_query_loki, grafana_list_prometheus_metric_names, grafana_list_prometheus_label_values, grafana_list_loki_label_names, grafana_list_loki_label_values, 그리고 탈출구(escape hatch)로서의 grafana_query_datasource. 타입화된 Prom/Loki 도구를 우선 사용하세요. 일반 프록시는 GET/POST만 지원하며, path는 /api/datasources/proxy/uid/<uid>/로 제한되어 Grafana 자체 API에는 접근할 수 없습니다. 용량 초과 결과에는 truncated: true가 포함됩니다.

  • 공유 AT Series Hub — Cursor / Kiro / Continue용 단일 AT Series MCP 항목; 플러그인별 MCP 서버 없음

Related MCP server: Grafana MCP Server

이번 릴리스에 포함되지 않은 사항

  • 단일 패널 드릴다운(전체 대시보드만 지원)

  • 레거시 Alerting(Unified Alerting만 지원)

  • Grafana 또는 데이터소스에 대한 모든 쓰기 / 음소거 / 일시 중지

  • 다중 조직 지원

  • 임베드 프록시를 통한 Grafana Live / WebSocket 푸시

설치

  1. VSIX 빌드(또는 게시된 릴리스 자산 사용):

    npm install
    npm run package   # produces at-grafana-0.1.3.vsix
  2. VS Code / Cursor에서: 확장 프로그램 → ⋯ → VSIX에서 설치… 를 선택하고 파일을 선택합니다.

  3. AT Grafana 활동 표시줄 보기를 연 다음 AT Grafana: Add Instance를 실행합니다.

빠른 시작

  1. Viewer 권한의 Grafana Service Account를 만들고 토큰을 복사합니다.

  2. AT Grafana: Add Instance → 라벨, 기본 URL, 토큰 → 연결 테스트 → TLS 지문 확인 → 저장.

  3. 대시보드 / 알림 탐색; 노드를 클릭하여 Webview에서 네이티브 페이지를 엽니다.

  4. (선택 사항, 에이전트용) 인스턴스를 편집하고 Allow background Agent access를 활성화합니다.

  5. (선택 사항) AT Grafana: Install/Repair AT Series MCP Config를 실행한 다음 MCP 클라이언트를 다시 연결합니다.

전체 가이드: docs/usage.md · 中文

에이전트 스킬

스킬

용도

at-grafana-mcp

AT Grafana MCP를 통해 대시보드 / 알림 규칙을 검사하고 Prometheus/Loki 스타일 데이터 쿼리

스킬 CLI로 설치:

npx skills add xwamt/At-grafana --skill at-grafana-mcp

개발

npm install
npm run typecheck
npm test
npm run build      # bundles dist/extension.js (+ webview + hub copy via package scripts)
npm run package    # produces at-grafana-<version>.vsix

이 폴더를 연 상태에서 F5를 눌러 Extension Development Host를 실행합니다.

Node.js 20+ 및 engines.vscode(^1.85.0)와 일치하는 VS Code / Cursor 호스트가 필요합니다.

문서

문서

설명

docs/features.md (中文)

기능 개요

docs/usage.md (中文)

설정, 에이전트 액세스, MCP 클라이언트

docs/releases/0.1.3.md

현재 릴리스 노트(17개 도구 MCP 카탈로그)

docs/releases/0.1.0.md

V1 완료 정의 / 승인 기록

docs/requirements.md

전체 요구사항 (中文)

skills/at-grafana-mcp/SKILL.md

에이전트용 MCP 카탈로그 가이드

docs/decisions/

ADR-001 … ADR-007

docs/plans/2026-07-29-at-grafana-v1-implementation-plan.md

단계별 구현 이력

at-terminal-series에서 스캐폴딩됨(독립적인 git 히스토리; SSH/SFTP/터미널 도메인 제거) — ADR-001 참조.

라이선스

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables AI-powered integration with Grafana instances through 52 MCP tools for dashboard management, Prometheus/Loki queries, alerting, and administrative functions. Supports complete Grafana functionality including metrics exploration, log analysis, and incident response through natural language.
      80
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to interact with Grafana dashboards, datasources, alerts, incidents, and monitoring data through 43 comprehensive tools. Supports querying Prometheus metrics, Loki logs, managing incidents, and dashboard operations with full authentication support.
      43
      690 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables MCP-compatible agents to interact with Grafana instances for searching, creating, and updating dashboards, exploring logs via Loki, querying datasources, managing alerts, incidents, and on-call shifts, and accessing observability data.
      13 PyPI
      8
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query Grafana dashboards, alerts, and datasources for observability insights and incident investigation.
      MIT