docker/sbx-kit-grafana:1.0.0

schemaVersion: "3"
displayName: Grafana (local)
description: Adds the official Grafana MCP server (mcp-grafana) plus the grafana-client Python library to an agent, pre-wired to a local Grafana on the host - no cloud account, no API token.
sourceUrl: https://github.com/grafana/mcp-grafana
version: 1.0.0
licenses:
    - Apache-2.0
kind: mixin
capabilities:
    - type: com.docker.sandbox/network-policy@1
      config:
        install:
            allow:
                - pypi.org
                - files.pythonhosted.org
    - type: com.docker.sandbox/lifecycle@1
      config:
        files:
            - content: |
                {
                  "mcpServers": {
                    "grafana": {
                      "command": "/home/agent/.local/bin/mcp-grafana",
                      "args": [],
                      "env": {
                        "GRAFANA_URL": "http://host.docker.internal:3000"
                      }
                    }
                  }
                }
              description: Portable MCP server definition - copy into any agent that reads an mcpServers block
              mode: "0644"
              overwrite: false
              path: /home/agent/.grafana/mcp.json
        install:
            - command: pip install --break-system-packages 'grafana-client==5.1.0'
              description: Install the grafana-client Python library (used by the runbooks and for shell verification)
              env:
                - HTTP_PROXY
                - HTTPS_PROXY
              user: "1000"
        startup:
            - command:
                - sh
                - -c
                - command -v claude >/dev/null 2>&1 && claude mcp add grafana -- /home/agent/.local/bin/mcp-grafana >/dev/null 2>&1 || true
              description: Register mcp-grafana with the Claude agent (best-effort; no-op elsewhere)
              user: "1000"
    - type: com.docker.sandbox/agent-context@1
      config:
        contentFile: /usr/share/sandbox/kit/grafana/grafana-context.md