At-grafana
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 SeriesMCP 항목; 플러그인별 MCP 서버 없음
Related MCP server: Grafana MCP Server
이번 릴리스에 포함되지 않은 사항
단일 패널 드릴다운(전체 대시보드만 지원)
레거시 Alerting(Unified Alerting만 지원)
Grafana 또는 데이터소스에 대한 모든 쓰기 / 음소거 / 일시 중지
다중 조직 지원
임베드 프록시를 통한 Grafana Live / WebSocket 푸시
설치
VSIX 빌드(또는 게시된 릴리스 자산 사용):
npm install npm run package # produces at-grafana-0.1.3.vsixVS Code / Cursor에서: 확장 프로그램 → ⋯ → VSIX에서 설치… 를 선택하고 파일을 선택합니다.
AT Grafana 활동 표시줄 보기를 연 다음 AT Grafana: Add Instance를 실행합니다.
빠른 시작
Viewer 권한의 Grafana Service Account를 만들고 토큰을 복사합니다.
AT Grafana: Add Instance → 라벨, 기본 URL, 토큰 → 연결 테스트 → TLS 지문 확인 → 저장.
대시보드 / 알림 탐색; 노드를 클릭하여 Webview에서 네이티브 페이지를 엽니다.
(선택 사항, 에이전트용) 인스턴스를 편집하고 Allow background Agent access를 활성화합니다.
(선택 사항) AT Grafana: Install/Repair AT Series MCP Config를 실행한 다음 MCP 클라이언트를 다시 연결합니다.
전체 가이드: docs/usage.md · 中文
에이전트 스킬
스킬 | 용도 |
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 호스트가 필요합니다.
문서
문서 | 설명 |
기능 개요 | |
설정, 에이전트 액세스, MCP 클라이언트 | |
현재 릴리스 노트(17개 도구 MCP 카탈로그) | |
V1 완료 정의 / 승인 기록 | |
전체 요구사항 (中文) | |
에이전트용 MCP 카탈로그 가이드 | |
ADR-001 … ADR-007 | |
단계별 구현 이력 |
at-terminal-series에서 스캐폴딩됨(독립적인 git 히스토리; SSH/SFTP/터미널 도메인 제거) — ADR-001 참조.
라이선스
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Query application logs, traces, and metrics from your AI coding assistant via Foam's MCP server.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
The Cortex MCP server provides read-only access to real-time engineering context from the Cortex developer portal, allowing AI coding assistants to answer natural language questions about your organization's catalog (microservices, libraries, domains, teams, infrastructure), scorecards (engineering standards and best practices), initiatives (goals and deadlines), and Engineering Intelligence metrics. It includes tools for querying documentation, tracking personal entities, and accessing AI-assisted insights across the entire Cortex ecosystem.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables 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.801MIT
- AlicenseBqualityDmaintenanceEnables 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.43690 npm3MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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 PyPI8Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query Grafana dashboards, alerts, and datasources for observability insights and incident investigation.MIT