README.md

Grafana Plugin Validator MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with the ability to validate Grafana plugins.

Configuration

Claude Code (CLI & VS Code Extension)

Add to ~/.claude.json (shared between CLI and VS Code extension):

{
  "mcpServers": {
    "grafana-plugin-validator": {
      "command": "npx",
      "args": ["-y", "@grafana/plugin-validator-mcp@latest"]
    }
  }
}

Project-Scoped Configuration:

Create .mcp.json in your project root:

{
  "grafana-plugin-validator": {
    "command": "npx",
    "args": ["-y", "@grafana/plugin-validator-mcp@latest"]
  }
}

For more details on MCP server types and configuration, see Claude Code Documentation.

Cline (VS Code Extension)

Add this to your Cline MCP settings:

{
  "mcpServers": {
    "grafana-plugin-validator": {
      "command": "npx",
      "args": ["-y", "@grafana/plugin-validator-mcp@latest"]
    }
  }
}

Codex

Edit ~/.codex/config.toml (or create .codex/config.toml in your project root for project-scoped configuration):

[mcp_servers.grafana-plugin-validator]
command = "npx"
args = ["-y", "@grafana/plugin-validator-mcp@latest"]

Claude Desktop

macOS: Edit ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: Edit ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "grafana-plugin-validator": {
      "command": "npx",
      "args": ["-y", "@grafana/plugin-validator-mcp@latest"]
    }
  }
}

Usage

Once configured, you can ask your AI assistant to validate Grafana plugins:

Validate this Grafana plugin: /path/to/plugin.zip

Check this plugin with source code:
- Plugin: ./my-plugin.zip
- Source: https://github.com/user/my-plugin

Available Tools

The MCP server provides the following tool:

validate_plugin

Validates a Grafana plugin and returns detailed diagnostics.

Parameters:

• pluginPath (required): Path or URL to the plugin archive (zip file)
• sourceCodeUri (optional): Path or URL to the plugin's source code for additional checks

Example:

{
  "pluginPath": "https://github.com/example/my-plugin/releases/download/v1.0.0/my-plugin.zip",
  "sourceCodeUri": "https://github.com/example/my-plugin"
}

License

Apache-2.0 License. See the LICENSE file for details.