AT Grafana

中文

AT Grafana 是 AT 系列（与 at-terminal-series 和 at-jumpserver-series 并列）中的一款 VS Code / Cursor 扩展。它将 Grafana 仪表盘和 Unified Alerting 引入 IDE，并通过共享的 @at-series/mcp-hub Protocol v1 向 Agents 暴露只读的 Grafana 元数据以及数据源查询（Prometheus、Loki 等）。

当前版本：0.1.0 — V1 功能完整。自动化测试套件：类型检查 + 292 项测试。针对真实 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 规则优先排序

• 原生嵌入式页面 — 通过本地 127.0.0.1 反向代理在扩展侧注入 Authorization（令牌对 Webview 不可见），提供完全可交互的 Grafana 仪表盘 / 告警详情界面

• 按实例的 Agent 访问开关 — “允许后台 Agent 访问”（默认关闭）；只有已启用的实例才会出现在 MCP 工具中

• 9 个 MCP 工具（risk: read，安装 AT Series MCP 后自动批准）：

  • 发现：grafana_list_instances

  • 管理：grafana_list_dashboards、grafana_get_dashboard、grafana_list_folders、grafana_list_alert_rules、grafana_get_alert_rule、grafana_get_alert_history

  • 监控：grafana_list_datasources、grafana_query_datasource（仅支持 GET/POST；path 限定在 /api/datasources/proxy/uid/<uid>/ 内，因此无法访问 Grafana 自身的 API；可配置时间范围 / 响应大小上限）

• 共享 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.0.vsix

2. 在 VS Code / Cursor 中：扩展 → ⋯ → 从 VSIX 安装… 并选择该文件。

3. 打开 AT Grafana 活动栏视图，然后运行 AT Grafana: Add Instance。

快速开始

1. 创建一个具有 Viewer 角色的 Grafana Service Account 并复制令牌。

2. AT Grafana: Add Instance → 标签、基础 URL、令牌 → Test connection → 确认 TLS 指纹 → 保存。

3. 浏览 Dashboards / Alerts；点击节点在 Webview 中打开原生页面。

4. （可选，供 Agents 使用）编辑实例并启用 Allow background Agent access。

5. （可选）AT Grafana: Install/Repair AT Series MCP Config，然后重新连接 MCP 客户端。

完整操作指南：docs/usage.md · 中文

Agent 技能

使用 skills 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 并打开此文件夹以启动扩展开发主机。

需要 Node.js 20+ 以及匹配 engines.vscode（^1.85.0）的 VS Code / Cursor 主机。

文档

从 at-terminal-series 脚手架生成（独立的 git 历史；已移除 SSH/SFTP/终端领域）— 参见 ADR-001。

许可证

MIT