grafana-assistant

Grafana AI Marketplace

Triple-format plugin marketplace that exposes the official Grafana MCP server for AI-assisted observability workflows in Cursor, Claude Code, and Kiro.

Getting started

1. Docker must be installed and running.

2. Create a service account in Grafana with at least Viewer role (or Editor for write operations). Generate a token.

3. Set environment variables:

   export GRAFANA_URL="http://localhost:3000"
   export GRAFANA_SERVICE_ACCOUNT_TOKEN="<your token>"
   

   For Grafana Cloud, use your instance URL instead (e.g. https://myinstance.grafana.net).

4. Install the plugin from the Cursor Marketplace, Claude Code plugin registry, or Kiro Powers panel.

Add plugins in Claude Code

From any Claude Code session, add this marketplace from GitHub:

/plugin marketplace add grafana/ai-marketplace

Install plugins from this marketplace (grafana-ai-marketplace):

/plugin install grafana-assistant@grafana-ai-marketplace
/plugin install grafana-mcp@grafana-ai-marketplace

What's included

• MCP server (mcp.json) — runs the official grafana/mcp-grafana Docker image in stdio mode, providing 50+ tools for dashboards, datasources, Prometheus, Loki, alerting, incidents, OnCall, annotations, and more.
• Rule (rules/grafana-assistant.mdc) — best practices for using Grafana MCP tools effectively (context window management, write safety, deeplinks).
• Kiro steering (steering/) — workflow-specific guidance files loaded on-demand by Kiro.

See plugins/grafana-mcp/README.md for the full tool reference.

Triple-format architecture

Each plugin ships manifests for all three platforms while sharing all content (rules, skills, MCP config):

plugins/grafana-mcp/
├── .cursor-plugin/plugin.json   # Cursor manifest
├── .claude-plugin/plugin.json   # Claude Code manifest
├── POWER.md                     # Kiro manifest (frontmatter + onboarding)
├── mcp.json                     # Shared MCP server config
├── rules/                       # Shared rules
└── steering/                    # Kiro steering files

Root marketplace manifests:

• .cursor-plugin/marketplace.json — Cursor Marketplace
• .claude-plugin/marketplace.json — Claude Code plugin registry
• .kiro-power/marketplace.json — Kiro Powers registry

Versions are kept in sync across all three formats and validated in CI.

Development

To validate the plugin structure (both formats):

node scripts/validate-template.mjs

To add more plugins, create a new directory under plugins/ and register it in all three marketplace manifests. See docs/add-a-plugin.md for details.